😙Contacts
Last updated
Last updated
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.
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.
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: +442071838750).
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.
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'.
Every new Contact (User) added to SENDUNE starts with a 2 star rating.
Depending on the way the Contact interacts with your emails (opens, clicks, etc), the rating goes up or down. If a Contact regularly opens your emails and clicks (engages) with them, the rating goes up. If a Contact marks your email as spam or unsubscribes, their rating becomes 1 and they are no longer sent emails.
Contact ratings help you understand who among of your Contacts are loyal to your brand and and who are not. This helps you design your communication strategies.
Contact ratings also help keep you email list clean and protect your domain reputation.
