Définir un message d'absence
Enregistrer la réponse d'une adresse ou d'un catch-all, en remplaçant ce qui était enregistré.
Exécute le véritable appel sur votre espace de travail.
PUT /out-of-office
Enregistrer la réponse d'une adresse ou d'un catch-all, en remplaçant ce qui était enregistré.
Exemple
Nécessite settings:write. address va dans la chaîne de requête, et message est le seul champ obligatoire : du texte brut de 1 à 10 000 caractères.
curl -X PUT "$OE/[email protected]" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "startsAt": "2026-12-22T00:00:00Z", "endsAt": "2027-01-04T08:00:00Z", "subject": "Away until 4 January", "message": "I am away until 4 January and will answer when I am back." }'{ "object": "out_of_office", "address": "[email protected]", "enabled": true, "active": true, "startsAt": "2026-12-22T00:00:00.000Z", "endsAt": "2027-01-04T08:00:00.000Z", "subject": "Away until 4 January", "message": "I am away until 4 January and will answer when I am back.", "contactsOnly": false, "updatedAt": "2026-12-22T09:14:03.117Z"}Omettez startsAt pour commencer maintenant, ou pour garder le début d'une réponse déjà active, et omettez endsAt ou passez null pour garder la réponse active jusqu'à ce qu'elle soit désactivée. subject accepte au plus 255 caractères, et s'il est laissé vide, la réponse part avec Re: et l'objet reçu. enabled: false garde le texte et met la réponse en pause, et contactsOnly: true ne répond qu'aux contacts et aux personnes à qui l'espace de travail a écrit.
Chaque expéditeur reçoit la réponse une seule fois pour toute la période d'absence, dans le même fil, depuis l'adresse à laquelle le courrier est arrivé. Changer startsAt ouvre une nouvelle période pendant laquelle chacun reçoit une réponse une fois de plus, et changer seulement le texte ou endsAt ne le fait pas. Sans endsAt, un expéditeur reçoit de nouveau une réponse après 30 jours. La réponse porte Auto-Submitted: auto-replied, n'a ni suivi ni signature, compte dans les envois mensuels, et part quand même sur un fil en sourdine.
Le courrier qui n'alerterait personne ne reçoit pas de réponse : les pourriels, le courrier qu'une règle a déplacé vers la corbeille, les newsletters et autres courriers de masse, le courrier automatique, les rebonds, les expéditeurs bloqués et les propres adresses de l'espace de travail. La réponse enregistrée pour l'adresse exacte s'applique d'abord, puis celle de l'adresse sans son suffixe plus, puis celle du catch-all, et un catch-all ne répond jamais pour une adresse que quelqu'un a créée à la main.
Un 422 invalid_parameter signifie que address manque, n'est pas une adresse de l'espace de travail ou nomme un domaine entier, que le message est vide, ou que endsAt n'est pas postérieur à startsAt ou est déjà passé. Rien ne tourne sur une minuterie : les dates sont vérifiées à l'arrivée du courrier.