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

{
"method": "POST",
"url": "https://api.sendwithses.com/add-contact",
"headers": {"x-api-key": "a2aa10aSeP8QnnON466aIRTqPFz8e3ZULWzPC2eXPhhvIu29xpamMqjVBY9S"},
"body": {
"email": "example@gmail.com",
"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 ...