Note that any active automation trigger will also work on a specific audience when the trigger condition matches during contact insert operation

Head over to API settings page and create an API key. Copy the API secret key and place it carefully in a secure place. The API Secret would be visible once only during creation. Also copy the client ID

APIKey.png

Then head over to the audience page and select the audience in which you would like to update the existing contact. Then Grab the audience ID

audienceId.png

Now that you have all the credentials needed for the API request, you can initiate the POST request from your backend


**REQUEST TYPE: POST**

API Endpoint

This is the API endpoint URL which would receive the update request

<https://api.mailboat.io/api/v1/contacts/create>

Authorization Header

The Authorization Header would consist of the API secret key which you retrieved from API Settings Page in Mailboat

Authorization: Bearer <API_SECRET_KEY>              //API secret key (Not the client ID) from your API Settings panel

POST Body Here is the sample payload body of the POST request

{
    "clientId": "2435a7c0-c5db-4583-8367-42c8e0640e42",  //Client ID is found in the API Settings at [<https://app.mailboat.io/api-settings>](<https://app.mailboat.io/api-settings>) 
    "audienceId": "b311387d-d535-4d88-86d3-2aa62795a4a5", //Audience ID can be found in the Audience Page with contacts below the name and description of the audience
    "contact": {                               //Ensure fields inside contact are having their property schema defined in Audience Page
        "first_name": "John Doe",                   
        "email_address":"[email protected]",  //email_address field is mandatory!
        "paid_at": "2022-08-28T20:44:03.969Z"      //Here 'paid_at' is a custom property which is added at audience page
    }
}