Obtener el buzón de respuestas

GET/v1/reply-mailbox

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

Para desarrolladores

Descripción

Entrega el buzón al que se reenvían las respuestas: el de la instancia, o el propio de un remitente. Las respuestas a los correos de un remitente van a su buzón confirmado; si no tiene, al de la instancia.

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:read. 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.

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:read.
404	No hay un buzón configurado (reply_mailbox_not_found), o no existe el remitente (sender_not_found).

Request

curl -X GET "https://$API_HOST/v1/reply-mailbox" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

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