😙Contacts

The Contacts module is the default landing page in SENDUNE. Each of your contact is represented by their Email ID or Mobile Number. You can add contacts manually or via the API or by importing a CSV file.

The contacts module in SENDUNE is very powerful and can scale to hold billions of contact metadata points. The easiest (and recommended) way to is to attach 'tags' to contacts. For example, if a user adds 'purple pants' to their wish-list, you attach the tag 'purple pants' to that user. You can then slice-n-dice this data to generate your own 'intelligence' and send targeted messages.

SENDUNE Contacts API

The 'add-contact' API is a simple, language agnostic, cURL request. It is used to add/update contacts as well as to attach/detach tags.

Click User+ icon at top right in SENDUNE dashboard to get this popup.

API Request

URL: https://api.sendune.com/add-contact

 {
      "method": "POST",
      "url": "https://api.sendune.com/add-contact",
      "headers": {"template-key": "*****************************zkLG"},
      "body": {
          "email": "[e-mail]",
          "status": "Unsubscribe",
          "full_name": "John Due",
          "mobile": "[phone]",
          "dob": "10-10-1990",
          "gender": "Male",
          "city": "Hyderabad",
          "country": "India",
          "add_tags": "aaa,bbb,ccc",
          "remove_tags": "ddd,eee,fff"
      }
 }

IMPORTANT:

• All API calls MUST include the Contact Upload Secret Key.

• All API calls MUST include the 'Primary Key' of the contact. Primary Key is used to uniquely identify a contact in the database. This is either the Email or the Mobile Number of your end user.

• Mobile numbers must strictly be in E.164 format. (Example: [phone]).

API Response

Success Response:

 {
      "success": true,
      "message": "Contact added"
 }

Failed Response:

 {
      "success": false,
      "message": "message details",
      "error": "error details"
 }

Rate Limits

Rate limits apply to the Contacts API (add-contact) endpoint as per the below table.

Plan	Rate Limit (requests/minute)
Free	60
Paid	1,800 (Soft Limit)
Enterprise	Upto 60,000

To illustrate, the 'Paid Plan' has a rate limit of 1800 requests/minute. This lets you call the SENDUNE Contacts API 30 times per second or do a single burst of 1800 calls in one second or anywhere in between. The sum total of all API calls must not exceed 1800 in one minute.

API rate limit is a soft limit for paid plans, meaning you can do occasional short bursts that exceed the rate limit as long as you are not abusing our systems.

IMPORTANT NOTE

Rate limits apply only to the Contacts API (add-contact) endpoint.

API rate limits do not apply to the Email, SMS, OTP endpoints.

Email/SMS sending rates are determined by AWS. For example, if your AWS SES email sending rate is 250/second, you can call the 'send-email' endpoint up to 250 times per second - even if you are on the 'Free Plan'.