`import_contacts`

View as .md

Import contacts.

Adds or updates 1 to 500 contacts. An address appears only once per audience. An invalid batch is refused as a whole. Triggers no send.

Access

Key: an Escouade Mail key with send.
Space: a verified space.
Changes nothing: no, it acts.
Safe to replay: use an idempotency_key where the tool offers one.

Parameters

Parameter	Type	Required	Description
`audience_id`	string	yes	Target audience.
`contacts`	list of object	yes	The contacts to add or update (1 to 500): address, name, fields and tags.

Call it

Terminal

curl -s https://api.subagent.fr/v1/import_contacts \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"audience_id": "…", "contacts": "…"}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/import_contacts.

This page in Markdown: /en/mail/docs/reference/import_contacts.md All the docs for an agent: /en/mail/docs/llms.txt Legal notice · Terms · Privacy · Service status