API

Unsubscribe contact

This example shows how to unsubscribe a contact from a mailing list.

Parameters

Parameters
FieldTypeDescriptionRequired / Optional
usernamestring

The username used to log in to MailCamp.

Required
usertokenstring

The unique token assigned to the user named above.

Required
requesttypestring

The name of the relevant API file.

Required
requestmethodstring

The name of the function being called.

Required
responsetypestring

The format of the response. This can be 'xml' or 'json'.

Optional
details

See the fields below.

Required
details.listidint

The ID of the mailing list the contact is on

Required
details.emailaddressstring

The email address of the contact you want to unsubscribe

Required

Successful response

Successful response
FieldTypeDescription
statusstring

The value of the status field is returned as “SUCCESS” on a successful response.

data

If the contact was unsubscribed successfully, the subscriberid is returned.

Error response

Error response
FieldTypeDescription
statusstring

The value of the status field will be “ERROR”.

errormessagestring

A text message explaining why the request failed.

Request example
<xmlrequest>
	<username>admin</username>
	<usertoken>0123456789abcdef0123456789abcdef01234567</usertoken>
	<requesttype>subscribers</requesttype>
	<requestmethod>UnsubscribeSubscriber</requestmethod>
	<responsetype>xml</responsetype>
	<details>
		<emailaddress>email@mailcamp.nl</emailaddress>
		<listid>99</listid>
		<subscriberid />
	</details>
</xmlrequest>