Adding contacts via API
Last updated February 4, 2024
Contacts can be imported in Mailmodo from your software stack via API. Using Mailmodo API, you can add contacts to a list without sending an email. The list will be available at Mailmodo portal so that you can use them for creating segment, sending campaign or triggering journey.
In this article, we will explain to different APIs available for you to add contacts into Mailmodo.
To make calls to Mailmodo APIs, you need to first generate the API keys .
Add a single contact
To add a single contact into a list in Mailmodo, use /addToList end point. Using the API, you can also update the contact properties of existing contact in the platform.
Once the contact is added to the list, the same can we used for creating segment, sending campaign or triggering journey. To learn more, checkout the API documentation on Add Contact to a list .
The data type for new contact properties (created via API) will be decided based on the values sent in the data object. Currently, we support Numbers, Booleans, Strings and Dates (in UNIX or ISO 8601) as data type in Mailmodo.
Add multiple contacts
To add multiple contacts into a list in Mailmodo, use /addToList/batch end point. Using the API, you can also update the contact properties of existing contacts in the platform.
Once the contacts are added to the list, the same can we used for creating segment or sending campaign. To learn more, checkout the API documentation on Bulk add contacts to a list .
Unlike /addToList API, contacts added to a list via batch API cannot be enrolled into a journey. This API is meant to be used for syncing your data from existing system to Mailmodo.