https://<subdomain>.sendsmaily.net/api/contact.php


POST method must be used for this query.


Parameters

All parameters must be URL encoded.


  

Parameter

Value

email

Email address. Must be exact (wildcard does not work). Required.

is_unsubscribed

0 - not unsubscribed, emails will be delivered;

1 - unsubscribed, email address will be excluded from all campaigns, even though the address can still be in the database and be included in filters.

is_deleted

0 - address is visible and can be used in filters;

1 - address is hidden from the database, from every filter and is not included in campaigns. It is not physically deleted from the database and will be restored with extra data intact after import.

...

Custom fields. New fields will be automatically created and attached with subscriber data. Text field.


Example query:


Unsubscribing an email address


Query to set support@smaily.com as unsubscribed.

  

$username = 'YOUR_USERNAME';
$password = 'YOUR_PASSWORD';
$location = 'https://<subdomain>.sendsmaily.net/api/contact.php';
$query = 'email=support%40smaily.com&is_unsubscribed=1';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $location);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $query);
curl_setopt($ch, CURLOPT_USERPWD, "$username:$password");

$result = curl_exec($ch);
curl_close($ch);

  

Result for a successful query:


{
  'code': 101,
  'message': 'OK'
}


 

See also other possible results from Possible results.