Send With SES
Search
⌃K
📇

Contacts API

NOTE: You can create a new contact or update an existing contact using this API.
Login to https://sendwithses.com and click the 'Add Contact' icon at the top-right corner. Then click 'Via API' in the popup.

API Post Request Parameters

x-api-key
Header
Contact Upload Secret Key
email
Body
Email ID of the Contact
status
Body
Subscribed, Unsubscribed
full_name
Body
Full Name of the Contact
isd_code
Body
ISD Code of the Contact (Ex: +44)
mobile
Body
Mobile Number
dob
Body
Date of Birth (DD-MM-YYYY)
gender
Body
Male or Female
city
Body
City
country
Body
Country
add_tags
Body
Tags of the Contact to be added (Separate multiple tags with commas)
remove_tags
Body
Tags of the Contact to be removed (Separate multiple tags with commas)
The API call MUST include the 'Contact Upload Secret Key' in the header (x-api-key) and 'email' in the body. Optionally you can include other parameters shown in table above.

Sample Request

{
"method": "POST",
"url": "https://api.sendwithses.com/add-contact",
"headers": {"x-api-key": "a2aa10aSeP8QnnON466aIRTqPFz8e3ZULWzPC2eXPhhvIu29xpamMqjVBY9S"},
"body": {
"email": "[email protected]",
"status": "Unsubscribe",
"full_name": "John Doe",
"isd_code": "+91",
"mobile": "8098763849",
"dob": "10-10-1990",
"gender": "Male",
"city": "Hyderabad",
"country": "India",
"add_tags": "aaa,bbb,ccc",
"remove_tags": "ddd,eee,fff"
}
}

API Response

Every API call returns a status code. Status Codes indicate whether an API operation is successful or not. A response code of 2xx indicates the operation was successful. Other error codes indicate either a client error (4xx) or a server error (5xx).
- For 4xx errors you must fix the POST Request and retry again. - For 5xx errors retry the request until it succeeds.

You can also add a contact manually ...

Or upload a CSV file containing your contacts ...

Need help? Write to [email protected]