Contacts · eusend

Add and manage individual contacts within an audience. Contacts can also be imported via CSV in the dashboard.

POST/audiences/:id/contacts

Add a single contact to an audience. If the email already exists in the audience the record is updated (upsert).

Parameter	Type	Description
`email`required	`string`	Contact email address.
`first_name`	`string`	Contact first name.
`last_name`	`string`	Contact last name.

POST/audiences/:id/contacts/batch

Upsert up to 1,000 contacts at once. Existing contacts (matched by email) are updated; new ones are inserted.

Parameter	Type	Description
`contacts`required	`array`	Array of contact objects. Each has email (required), first_name, last_name.

batch upsert contacts

curl -X POST https://api.eusend.dev/audiences/550e8400-e29b-41d4-a716-446655440000/contacts/batch \
  -H "Authorization: Bearer eu_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      { "email": "alice@example.com", "first_name": "Alice" },
      { "email": "bob@example.com",   "first_name": "Bob"   }
    ]
  }'

The rest of the contacts surface:

GET/audiences/:id/contacts

List contacts.

GET/audiences/:id/contacts/:contactId

Get a contact.

PATCH/audiences/:id/contacts/:contactId

Update contact (name, unsubscribed).

DELETE/audiences/:id/contacts/:contactId

Remove a contact.