API

Change email address

This example shows how an email address can be changed.

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
subscriberidsint

The ID of the contact whose email address must be changed. You can retrieve this ID with the request method 'IsSubscriberOnList'.

Required
emailaddressstring

The new email address of the contact.

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>UpdateEmailAddress</requestmethod>
	<responsetype>xml</responsetype>
	<details>
		<subscriberids>9999</subscriberids>
		<emailaddress>email@mailcamp.nl</emailaddress>
	</details>
 </xmlrequest>