주소 전달
메일함 말고도 주소의 메일이 가는 곳. 모든 대상은 무언가를 받기 전에 이메일로 확인합니다.
5개 호출을 워크스페이스에 실제로 실행합니다.
GET /domains/{id}/addresses/{addressId}/forwards
메일함 말고도 주소의 메일이 가는 곳. 모든 대상은 무언가를 받기 전에 이메일로 확인합니다.
대상 목록 조회
domains:read가 필요합니다. 주소의 모든 대상을 오래된 순으로 반환합니다. destination은 주소가 여기에도 사본을 남기는지(mailbox) 전달만 하는지(forward) 알려 주고, max는 주소 하나가 가질 수 있는 대상의 수입니다.
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는 대상이 메일을 받겠다고 확인하면 live, 아직 응답하지 않은 동안은 pending, 거절하면 refused, 꺼져 있는 동안은 paused입니다. live인 대상만 무언가를 받습니다.
대상 추가
domains:write가 필요합니다. POST /domains/{id}/addresses/{addressId}/forwards에 주소 1~10개를 담은 { emails }를 보냅니다. 새 대상마다 확인을 요청하는 이메일이 가므로, 처음에는 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." } ]}여기서 호스팅되는 주소, 이미 목록에 있는 주소, 루프를 만들 주소, 한도인 10개를 넘는 주소, 이 워크스페이스의 메일을 거부한 주소는 이유와 함께 skipped에 나오고, 나머지는 그대로 추가됩니다.
꺼져 있는 주소는 409 address_disabled로 거부됩니다.
특정 주소나 도메인으로 제한된 키는 도메인 전체를 보유해야 하며, 멤버를 대신하는 앱은 그 멤버가 닿는 주소만 전달할 수 있습니다.
OAuth 액세스 토큰으로 이 호출을 하려면 인증 코드가 필요합니다. 앱이 최근 60분 안에 코드를 인증하기 전까지 호출은 403 step_up_required로 응답하고 아무것도 바꾸지 않습니다. API 키는 요구받지 않습니다. 코드를 요청하고 인증하는 방법은 인증 페이지에 있습니다.
대상 일시 중지 또는 켜기
domains:write가 필요합니다. PATCH /domains/{id}/addresses/{addressId}/forwards/{forwardId}에 { enabled }를 보냅니다. 일시 중지된 대상은 확인을 그대로 유지하므로 다시 켤 때 확인이 필요 없습니다.
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"}켜져 있던 마지막 대상을 일시 중지하면 주소는 다시 메일을 여기에 보관하며, destination도 그렇게 알려 줍니다.
OAuth 액세스 토큰으로 이 호출을 하려면 인증 코드가 필요합니다. 앱이 최근 60분 안에 코드를 인증하기 전까지 호출은 403 step_up_required로 응답하고 아무것도 바꾸지 않습니다. API 키는 요구받지 않습니다. 코드를 요청하고 인증하는 방법은 인증 페이지에 있습니다.
대상 제거
domains:write가 필요합니다. DELETE /domains/{id}/addresses/{addressId}/forwards/{forwardId}. 그 대상으로는 더 이상 아무것도 전달되지 않습니다.
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"}그것이 켜져 있던 마지막 대상이었다면 주소는 다시 메일을 여기에 보관합니다.
OAuth 액세스 토큰으로 이 호출을 하려면 인증 코드가 필요합니다. 앱이 최근 60분 안에 코드를 인증하기 전까지 호출은 403 step_up_required로 응답하고 아무것도 바꾸지 않습니다. API 키는 요구받지 않습니다. 코드를 요청하고 인증하는 방법은 인증 페이지에 있습니다.
대상에 다시 확인 요청
domains:write가 필요합니다. POST /domains/{id}/addresses/{addressId}/forwards/{forwardId}/resend는 확인 이메일을 한 번 더 보냅니다.
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는 sent, 대상에 아무것도 필요 없으면 already-confirmed, 마지막 이메일이 방금 나갔으면 too-soon, 대상이 이 워크스페이스의 메일을 거부했으면 revoked, 이메일을 보낼 수 없었으면 send-failed입니다.
OAuth 액세스 토큰으로 이 호출을 하려면 인증 코드가 필요합니다. 앱이 최근 60분 안에 코드를 인증하기 전까지 호출은 403 step_up_required로 응답하고 아무것도 바꾸지 않습니다. API 키는 요구받지 않습니다. 코드를 요청하고 인증하는 방법은 인증 페이지에 있습니다.