Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

remove_audience_contact

View as .md

Remove a contact from the audience.

Removes the address from an audience. Campaigns already scheduled keep their list; to stop every send, use add_suppression.

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

ParameterTypeRequiredDescription
audience_idstringyesAudience.
emailstringyesExact address.

Call it

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

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