Guardar el buzón de respuestas

PUT/v1/reply-mailbox

PUT/v1/senders/{id}/reply-mailbox

Para desarrolladores

Descripción

Guarda el buzón que recibe una copia de cada respuesta de una persona, con la respuesta adjunta y el Reply-To de quien respondió. Las respuestas automáticas y las que el antispam marca no se reenvían.

La dirección recibe un código de confirmación, que se envía a POST .../confirm. Hasta entonces el buzón queda pending y no recibe nada. No se pide código para una dirección que esta instancia ya confirmó, ni para una bajo *.sandbox.

Con un buzón confirmado, los correos sin Reply-To propio llevan la dirección de respuesta de la plataforma: los de todos los remitentes con el buzón de la instancia, y los de ese remitente con el suyo. El cambio tarda unos 10 segundos en aplicarse a los correos que se envían.

Guardar otra dirección deja al buzón pending: mientras tanto, las respuestas de ese remitente van al buzón de la instancia, si tiene uno confirmado.

Guía relacionada

• Buzón de respuestas — Reciba en un buzón suyo una copia de cada respuesta a sus correos.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope replies:write. Formato: Bearer <API_KEY>.

X-Instance-Slugstringheaderobligatorio

Identificador de su instancia. Ver Autenticación.

Request

Path params (solo en la ruta del remitente):

idinteger

Identificador del remitente.

Body:

addressstringobligatorio

Dirección del buzón. Hasta 254 caracteres.

Response

200 OKDevuelve un objeto con los campos que siguen.

addressstringsiempre presente

Dirección del buzón, en minúsculas.

sender_idinteger | nullsiempre presente

Remitente dueño del buzón. null es el de la instancia.

statusstringsiempre presente

confirmed, o pending si todavía no se confirmó. Un buzón pending no recibe respuestas.

confirmed_atstring (fecha y hora UTC) | nullsiempre presente

Cuándo se confirmó.

created_atstring (fecha y hora UTC)siempre presente

Cuándo se creó.

Errores

Código	Cuándo
403	La API key no tiene el scope replies:write.
404	No existe el remitente (sender_not_found).
409	Se envió un código hace menos de un minuto (reply_mailbox_code_recently_sent).
422	La dirección no es válida (reply_mailbox_address_invalid), o su dominio recibe el correo a través de la plataforma (reply_mailbox_platform_domain).
503	No se pudo consultar el DNS del dominio. Reintente.

Request

curl -X PUT "https://$API_HOST/v1/reply-mailbox" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG" \
-H "Content-Type: application/json" \
-d '{
  "address": "ventas@example.com"
}'

Response

{
"address": "ventas@example.com",
"sender_id": null,
"status": "pending",
"confirmed_at": null,
"created_at": "2026-11-01T12:00:00Z"
}