The Yourdiai API keeps your contacts and lists in sync with your other systems, such as SendGrid, Brevo, your CRM or your website's sign-up form.
- 01Open API keys in your workspace. Owners and admins can create keys.
- 02Select Create API key, name it and choose its access: read only, or read and write.
- 03Copy the key straight away. It is shown only once.
- 04Send it with every request in the Authorization header: Bearer followed by your key.
Syncing contacts
- Send up to 1,000 contacts per request to the batch endpoint. Contacts are matched by email, so you can repeat a sync safely.
- Mark people who unsubscribed at your previous provider as unsubscribed, so they never receive your campaigns.
- An unsubscribed or suppressed contact is never subscribed again by a sync.
- Contacts over your plan’s contact limit are reported back and not created.
Good to know
The API works once your workspace is approved and on a paid plan. Each workspace can make 120 requests a minute. The full API reference is at https://yourdiai.com/docs/api.