This example shows how tags can be unlinked from a contact.

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
subscriberidint

This field is required unless you pass the email address and the listid in the call. The ID of the contact the tags must be unlinked from. You can retrieve this ID with the request method 'IsSubscriberOnList'.

Optional
listidint

This field is required unless you pass the subscriberid in the call. The ID of the mailing list that the contact, from whom the tags must be unlinked, is on.

Optional
emailadressstring

This field is required unless you pass the subscriberid in the call. The email address of the contact the tags must be unlinked from.

Optional
tagsstring

Enter the IDs of the tags here, comma-separated.

Required

Successful response

Successful response
FieldTypeDescription
statusstring

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

data

If the statistics are found, the object is returned.

Error response

Error response
FieldTypeDescription
statusstring

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

errormessagestring

A text message explaining why the request failed.

Request example
<xmlrequest>
	<username>admin</username>
	<usertoken>0123456789abcdef0123456789abcdef01234567</usertoken>
	<requesttype>subscribers</requesttype>
	<requestmethod>DeleteSubscriberTags</requestmethod>
	<responsetype>xml</responsetype>
	<details>
		<subscriberid>9999</subscriberid>
		<listid>9999</listid>
		<emailaddress>email@mailcamp.nl</emailaddress>
		<tags>1,2,3,4</tags>
	</details>
 </xmlrequest>