Confirmar el buzón de respuestas

POST/v1/reply-mailbox/confirm

POST/v1/senders/{id}/reply-mailbox/confirm

Para desarrolladores

Descripción

Confirma un buzón con el código que recibió. El código vale 15 minutos y admite 5 intentos. Si vence o se agotan los intentos, guardar la dirección de nuevo envía otro. Confirmar un buzón ya confirmado no cambia nada.

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:

codestringobligatorio

El código que recibió el buzón.

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 hay un buzón configurado (reply_mailbox_not_found), o no existe el remitente (sender_not_found).
409	El código venció (reply_mailbox_code_expired) o se agotaron los intentos (reply_mailbox_code_attempts_exhausted).
422	El código no es el enviado (reply_mailbox_code_invalid).

Request

curl -X POST "https://$API_HOST/v1/reply-mailbox/confirm" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG" \
-H "Content-Type: application/json" \
-d '{
  "code": "123456"
}'

Response

{
"address": "[email protected]",
"sender_id": null,
"status": "confirmed",
"confirmed_at": "2026-11-01T12:05:00Z",
"created_at": "2026-11-01T12:00:00Z"
}