How to Import Databases via API in Icomm
With Icomm, it is possible to automatically import databases through our Contacts API. This tool will allow you to efficiently manage your contacts and databases in a more automated way. Below, we will explain how to use our APIs to add, update, delete, and unsubscribe contacts on your Icomm platform.
To start using our Contacts API, you must first access our centralized API portal to obtain the necessary documentation. You can find this valuable information on the Developers Portal.
One of the most essential functions of our APIs is the ability to add or update a contact in your database. This allows you to keep your contacts' information up to date. Here are some key details about this functionality:
- Add a contact: You can add a new contact to an existing profile in the system by providing all the customized information related to it. If the contact already exists in the database (identified by the email address), custom fields will be updated based on the provided data. Information in non-updated fields will remain as it was at the time of the update request.
- Contact status: Newly registered contacts in the system are considered enabled unless identified as bounced in the main bounce database maintained by the platform. In this case, the contact will be loaded but appear as rejected. If a contact had been previously unsubscribed, it will be added to the profile but will not receive information unless manually re-enabled.
- Date format: When loading values for custom fields that store date-like data, make sure to avoid ambiguous formats and use "dd/mm/yyyy."
Before you can add new contacts to a profile, you will need to obtain the corresponding key (Profile_Key) for that profile from the platform. Detailed documentation is available on our Developers Portal.
If you need to add more than one contact to a specific profile in your system, our APIs allow you to do so efficiently. This includes the ability to add multiple contacts with customized information for each. Like in the previous case, you need to obtain the key (Profile_Key) of the profile before using this functionality. Complete documentation is available on our Developers Portal.
To keep your database organized, you can use our APIs to delete any contact from an existing profile in the system. Before taking this action, make sure to obtain the key (Profile_Key) corresponding to the platform. For detailed information on how to perform this operation, refer to our Developers Portal.
If you need to unsubscribe a contact from your instance, our APIs provide you with the ability to do so easily. You can find complete documentation on how to perform this operation on our Developers Portal.
We hope this guide has provided you with a comprehensive overview of how to import databases through our Contacts APIs at Icomm! You can always refer to our documentation on the developer portal for more detailed information and ensure you use our APIs efficiently and effectively.
Accessing the Developer Portal
To start using our Contacts API, you must first access our centralized API portal to obtain the necessary documentation. You can find this valuable information on the Developers Portal.
Add/Update a Contact
One of the most essential functions of our APIs is the ability to add or update a contact in your database. This allows you to keep your contacts' information up to date. Here are some key details about this functionality:
- Add a contact: You can add a new contact to an existing profile in the system by providing all the customized information related to it. If the contact already exists in the database (identified by the email address), custom fields will be updated based on the provided data. Information in non-updated fields will remain as it was at the time of the update request.
- Contact status: Newly registered contacts in the system are considered enabled unless identified as bounced in the main bounce database maintained by the platform. In this case, the contact will be loaded but appear as rejected. If a contact had been previously unsubscribed, it will be added to the profile but will not receive information unless manually re-enabled.
- Date format: When loading values for custom fields that store date-like data, make sure to avoid ambiguous formats and use "dd/mm/yyyy."
Before you can add new contacts to a profile, you will need to obtain the corresponding key (Profile_Key) for that profile from the platform. Detailed documentation is available on our Developers Portal.
Add/Update Multiple Contacts
If you need to add more than one contact to a specific profile in your system, our APIs allow you to do so efficiently. This includes the ability to add multiple contacts with customized information for each. Like in the previous case, you need to obtain the key (Profile_Key) of the profile before using this functionality. Complete documentation is available on our Developers Portal.
Delete Contact from a Profile
To keep your database organized, you can use our APIs to delete any contact from an existing profile in the system. Before taking this action, make sure to obtain the key (Profile_Key) corresponding to the platform. For detailed information on how to perform this operation, refer to our Developers Portal.
Unsubscribe Contact
If you need to unsubscribe a contact from your instance, our APIs provide you with the ability to do so easily. You can find complete documentation on how to perform this operation on our Developers Portal.
We hope this guide has provided you with a comprehensive overview of how to import databases through our Contacts APIs at Icomm! You can always refer to our documentation on the developer portal for more detailed information and ensure you use our APIs efficiently and effectively.
Updated on: 03/01/2024
Thank you!