Reenviar una dirección
Adónde va el correo de una dirección además de a su buzón. Cada destino confirma por correo antes de recibir nada.
Ejecuta cualquiera de las 5 llamadas en tu espacio de trabajo.
GET /domains/{id}/addresses/{addressId}/forwards
Adónde va el correo de una dirección además de a su buzón. Cada destino confirma por correo antes de recibir nada.
Listar los destinos
Requiere domains:read. Todos los destinos de la dirección, los más antiguos primero. destination indica si la dirección también guarda una copia aquí (mailbox) o solo reenvía (forward), y max es cuántos destinos puede tener una dirección.
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards" -H "$AUTH"{ "object": "list", "address": "[email protected]", "destination": "mailbox", "max": 10, "data": [ { "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": true, "status": "live", "confirmedAt": "2026-09-26T08:12:40.000Z", "askedAt": "2026-09-26T08:02:11.000Z", "lastRelayAt": "2026-09-30T16:45:03.000Z", "lastError": null, "failures": 0, "createdAt": "2026-09-26T08:02:11.000Z" } ]}status es live cuando el destino ha confirmado que quiere el correo, pending mientras no ha respondido, refused cuando dijo que no y paused mientras está desactivado. Solo un destino live recibe algo.
Añadir destinos
Requiere domains:write. POST /domains/{id}/addresses/{addressId}/forwards con { emails }, de 1 a 10 direcciones. A cada destino nuevo se le envía un correo que le pide confirmar, así que empieza en pending.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "emails": ["[email protected]", "[email protected]"] }'{ "object": "address_forwards", "added": [ { "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": true, "status": "pending", "confirmedAt": null, "askedAt": "2026-09-26T08:02:11.000Z", "lastRelayAt": null, "lastError": null, "failures": 0, "createdAt": "2026-09-26T08:02:11.000Z" } ], "skipped": [ { "email": "[email protected]", "reason": "[email protected] is hosted here, so it cannot be a forwarding destination. Share the address with that person instead." } ]}Una dirección alojada aquí, una que ya está en la lista, una que crearía un bucle, una que supera el límite de 10 y una que rechazó el correo de este espacio de trabajo aparecen en skipped con el motivo, y las demás se añaden igualmente.
Una dirección desactivada se rechaza con 409 address_disabled.
Una clave limitada a determinadas direcciones o dominios necesita tener el dominio entero, y una app que actúa por un miembro solo puede reenviar una dirección a la que llega ese miembro.
Un token de acceso OAuth necesita un código de verificación para esta llamada. Hasta que la app haya verificado uno en los últimos 60 minutos, la llamada responde 403 step_up_required y no cambia nada. A una clave de API nunca se le pide. La página Autenticación muestra cómo pedir un código y verificarlo.
Pausar o activar un destino
Requiere domains:write. PATCH /domains/{id}/addresses/{addressId}/forwards/{forwardId} con { enabled }. Un destino en pausa conserva su confirmación, así que volver a activarlo no necesita ninguna.
curl -X PATCH "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "enabled": false }'{ "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": false, "status": "paused", "destination": "mailbox"}Cuando se pausa el último destino activado, la dirección vuelve a guardar su correo aquí, y destination lo indica.
Un token de acceso OAuth necesita un código de verificación para esta llamada. Hasta que la app haya verificado uno en los últimos 60 minutos, la llamada responde 403 step_up_required y no cambia nada. A una clave de API nunca se le pide. La página Autenticación muestra cómo pedir un código y verificarlo.
Quitar un destino
Requiere domains:write. DELETE /domains/{id}/addresses/{addressId}/forwards/{forwardId}. Ya no se le reenvía nada más.
curl -X DELETE "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d" -H "$AUTH"{ "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "deleted": true, "destination": "mailbox"}Si era el último destino activado, la dirección vuelve a guardar su correo aquí.
Un token de acceso OAuth necesita un código de verificación para esta llamada. Hasta que la app haya verificado uno en los últimos 60 minutos, la llamada responde 403 step_up_required y no cambia nada. A una clave de API nunca se le pide. La página Autenticación muestra cómo pedir un código y verificarlo.
Pedir de nuevo a un destino que confirme
Requiere domains:write. POST /domains/{id}/addresses/{addressId}/forwards/{forwardId}/resend envía una vez más el correo de confirmación.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d/resend" -H "$AUTH"{ "object": "address_forward_consent", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "status": "sent"}status es sent, already-confirmed cuando el destino no necesita nada, too-soon cuando el último correo salió hace un momento, revoked cuando el destino rechazó el correo de este espacio de trabajo, o send-failed cuando no se pudo enviar el correo.
Un token de acceso OAuth necesita un código de verificación para esta llamada. Hasta que la app haya verificado uno en los últimos 60 minutos, la llamada responde 403 step_up_required y no cambia nada. A una clave de API nunca se le pide. La página Autenticación muestra cómo pedir un código y verificarlo.
Referencia
/domains/{id}/addresses/{addressId}/forwardsReferencia completa/domains/{id}/addresses/{addressId}/forwardsReferencia completa/domains/{id}/addresses/{addressId}/forwards/{forwardId}Referencia completa/domains/{id}/addresses/{addressId}/forwards/{forwardId}Referencia completa/domains/{id}/addresses/{addressId}/forwards/{forwardId}/resendReferencia completa