Contacts

Add or upsert a contact

Addresses are lowercased. Adding an address already in the audience updates it rather than failing.

post/audiences/{id}/contacts

Request

  • Base URL: https://api.eusend.dev
  • URL: https://api.eusend.dev/audiences/{id}/contacts
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The audience id.

Request body

emailstring email required
first_namestring
last_namestring
propertiesobject

Custom properties, available as {{key}} in a broadcast body. Keys are lowercase letters, digits and underscores, starting with a letter (max 40 characters, 20 properties per contact). email, name, first_name, last_name and full_name are built in and are rejected here.

Response

Created or updated.

idstring uuid required
audienceIdstring uuid required
emailstring email required
firstNamestring nullable
lastNamestring nullable
propertiesobject

Custom properties, usable as {{key}} in a broadcast body.

status'subscribed' | 'unsubscribed' required
unsubscribedAtstring date-time nullable
createdAtstring date-time required
updatedAtstring date-time nullable

Changes

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