Adding contacts to a specific list using the Audience Republic API can be a seamless process when set up correctly.

Before you get started

• Make sure you have access to the API tokens in the Account Settings section:
  

How to add contacts to a list using the API

Step 1: Trigger the Mail Call

After adding a contact, trigger the mail call to ensure the contact is added to the intended list. This can be done immediately after creating the contact.

Step 2: Automate the Process

To streamline the process, you can set up an automated workflow where the mail call is triggered upon receiving a contact ID (email address). This ensures contacts are promptly assigned to the correct list without manual intervention. 

Please note, it can sometimes take up to 24 hours for emails to land in the console 

Step 3: Use the Tagging Feature

The API includes a field for adding tags in the Contacts call section. By assigning tags to your contacts during the API call, they will automatically be categorized into the appropriate list. This eliminates the need for manual sorting or categorization.

Helpful Resources

• API Documentation: For detailed instructions and examples, refer to the Audience Republic API documentation.
• Assigning Contacts: Learn more about assigning contacts to lists in the Contacts call section.
• Testing API Calls: Follow our step-by-step guide on API Test Calls to verify your setup and troubleshoot any issues.

By following these steps and using the tagging feature, you can efficiently add contacts to specific lists and streamline your workflow.

About API tokens

The design is asynchronous, data sent to this API is loaded into temporary storage (the 'Ingestion DB'), held there (currently for around 15 minutes) then eventually loaded into the database that backs the website. During this process, it does not have access to the IDs that will be used in the primary DB. This API expects you, the caller, to provide your own IDs that can be used to track objects.

Still need help?

Contact us at [email protected]