📇
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.

| | |
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.
{
"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"
}
}
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.


Need help? Write to [email protected]
Last modified 3mo ago