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

1
{
2
"method": "POST",
3
"url": "https://api.sendwithses.com/add-contact",
4
"headers": {"x-api-key": "a2aa10aSeP8QnnON466aIRTqPFz8e3ZULWzPC2eXPhhvIu29xpamMqjVBY9S"},
5
"body": {
6
"email": "[email protected]",
7
"status": "Unsubscribe",
8
"full_name": "John Doe",
9
"isd_code": "+91",
10
"mobile": "8098763849",
11
"dob": "10-10-1990",
12
"gender": "Male",
13
"city": "Hyderabad",
14
"country": "India",
15
"add_tags": "aaa,bbb,ccc",
16
"remove_tags": "ddd,eee,fff"
17
}
18
}
Copied!

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]

Last modified 2mo ago