contacts

Create Contact via DOI (Double-Opt-In) Flow

<Note title="How to use attributes param?">attributes param in this endpoint is an object containing key-value pairs where values can be either a string, integer, array, or boolean. You can create key-value pairs with these four datatypes. When a value is an array, it should be an array of strings.</Note>

post/contacts/doubleOptinConfirmation

Request

  • Base URL: https://api.brevo.com/v3
  • URL: https://api.brevo.com/v3/contacts/doubleOptinConfirmation
  • Auth: API key in header api-key

Request body

attributesobject

Pass the set of attributes and their values. These attributes must be present in your Brevo account. For eg. {'FNAME':'Elly', 'LNAME':'Roger', 'COUNTRIES': ['India','China']}

contactPixelTrackingConsentboolean

Consent of the DOI recipient for open (pixel) and click tracking in the double opt-in confirmation email, resolved by the sender at send time. Considered only if the per-contact pixel tracking consent feature is enabled for your account. Pass true if this recipient has consented to open and click tracking, in which case the open pixel and tracked links identify the recipient. Pass false to anonymise the open and click events (counted in aggregate statistics only). If it is not passed, the recipient is treated as unknown consent status and the email is still sent (the open and click are anonymised unless your account tracks unknown-consent contacts). A value other than true/false is rejected. Ignored when the feature is not enabled for your account.

emailstring email required

Email address where the confirmation email will be sent. This email address will be the identifier for all other contact attributes.

excludeListIdsinteger[]

Lists under user account where contact should not be added

includeListIdsinteger[] required

Lists under user account where contact should be added

redirectionUrlstring url required

URL of the web page that user will be redirected to after clicking on the double opt in URL. When editing your DOI template you can reference this URL by using the tag {{ params.DOIurl }}.

templateIdinteger required

Id of the Double opt-in (DOI) template

Response

DOI Contact created

ContactsCreateDoiContactResponse201 required

Empty response body

Changes

No recorded changes to this operation across all 1 revision of this API.