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
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
"full_name": "John Doe",
8
"isd_code": "+91",
9
"mobile": "8098763849",
10
"dob": "10-10-1990",
11
"gender": "Male",
12
"city": "Hyderabad",
13
"country": "India",
14
"add_tags": "aaa,bbb,ccc",
15
"remove_tags": "ddd,eee,fff"
16
}
17
}
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 1yr ago