Skip to main content

Add Contact

warning

Before using the audience recipient manipulation operations it is necessary to first create an audience for your Organization through the Arpoone platform. This option is available on the menu: Audience > Create Audience

This endpoint allows for the addition of a recipient to an organization's audience.

The use of this endpoint is only allowed after an audience has been created via the Arpoone platform. If no audience is defined for the organization, an error will be returned with HTTP Status Code 400 – Bad Request and Code=AUDIENCE_SCHEMA_NOT_FOUND.

The request body must contain a recipient object where the tags and subscriptions fields are optional, and the fields in the fields array must comply with the audience schema.

This operation is also subject to the following restrictions:

  • The fields object must contain all the key columns defined in the audience schema;
  • There cannot be another contact in the audience with the same key field values.

If any of these conditions are not met, the API will return an HTTP Status Code 400 – Bad Request error.

Access the API Reference