Référence APIAjouter un destinataire
POST/v1/recipients

Ajouter un destinataire

Ajoute un destinataire au carnet d'adresses.

1 min de lectureTélécharger en PDF

Requête exemple

{
"name": "Alice Johnson",
"email": "alice@example.com"
}

Réponse exemple

{
"recipient": {
"id": "rec_12345abcde",
"name": "Alice Johnson",
"email": "alice@example.com",
"created_at": "2026-01-15T10:30:00Z"
}
}

Ajoute un destinataire au carnet d'adresses. Si l'email existe déjà, l'enregistrement est mis à jour (upsert).

Authentification

Requiert une clé API avec le scope address_book:manage.

Corps de la requête

ChampTypeRequisDescription
emailstringOuiAdresse e-mail (normalisée en minuscules et validée).
namestringNonNom du destinataire.

Codes de statut

  • 201 Créé ou mis à jour.
  • 400 Email invalide.
  • 403 Scope insuffisant.