Aller à la documentation
API

Se désabonner d'un expéditeur

Ce que fait le bouton « Se désabonner » de la page Abonnements.

POST/subscriptions/{id}/unsubscribe

Exécute le véritable appel sur votre espace de travail.

POST /subscriptions/{id}/unsubscribe

Ce que fait le bouton « Se désabonner » de la page Abonnements.

Exemple

Nécessite threads:write. Se désabonne de la façon que demande l'expéditeur : une demande en un clic s'il en propose une, sinon un e-mail de désabonnement envoyé depuis l'adresse à laquelle le courrier est arrivé. bin: true déplace aussi toutes les conversations de l'expéditeur dans la corbeille. Le corps est facultatif.

curl
curl -X POST "$OE/subscriptions/sub_5d2c8e17/unsubscribe" -H "$AUTH" \  -H "Content-Type: application/json" -d '{ "bin": true }'
Réponse
{  "object": "unsubscribe",  "subscriptionId": "sub_5d2c8e17",  "method": "one-click",  "url": null,  "binned": 58}

Un expéditeur qui ne propose qu'une page répond avec method link et la page dans url, qu'une personne doit ouvrir.

Un expéditeur qui n'offre aucun moyen de se désabonner donne un 422 unsubscribe_unsupported, et un expéditeur qui n'a pas accepté la demande en un clic et ne donne aucune adresse à laquelle écrire donne un 502 unsubscribe_refused. Dans les deux cas, rien n'a changé.

Référence