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

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/update>

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
    "emailAddressIdentifier": "[email protected]", //Email Addresss Identifier is the email address of the contact for which you would like to change the email
    "updateFields": {                               //Update fields can update fields only for those mentioned in property definition at audience page
        "first_name": "John Doe",                   
        "email_address":"[email protected]", 
        "paid_at": "2022-08-28T20:44:03.969Z"      //Here 'paid_at' is a custom property which is added at audience page
    }
}