API
주소 생성
도메인에 주소를 만듭니다. 도메인이 수신하는 즉시 수신하며, 도메인이 발신할 수 있게 되면 그 주소로 보낼 수 있습니다.
POST/domains/{id}/addresses
본인 키로 워크스페이스에 실제 호출을 실행합니다.
POST /domains/{id}/addresses
도메인에 주소를 만듭니다. 도메인이 수신하는 즉시 수신하며, 도메인이 발신할 수 있게 되면 그 주소로 보낼 수 있습니다.
요청
매개변수
localPartstring필수- `@` 앞부분. 1~64자이며 소문자로 바뀝니다. `*`는 catch-all을 표기하는 방식이므로 그 자체로 주소가 될 수 없습니다.
labelstring | null- 앱에서 쓰는 주소의 이름. 최대 120자.
예시
domains:write가 필요합니다. 특정 주소나 도메인으로 제한된 키는 도메인 전체를 보유해야 합니다.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "localPart": "billing", "label": "Invoices" }'{ "object": "address", "id": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "address": "[email protected]", "localPart": "billing", "label": "Invoices", "enabled": true, "lastReceivedAt": null, "createdAt": "2026-09-25T10:00:00.000Z", "updatedAt": "2026-09-25T10:00:00.000Z"}삭제된 주소를 만들면 활성 상태로 되살아납니다. 이미 있는 주소를 만들면 다시 켜서 반환하며, 라벨은 보낸 경우에만 바뀝니다.
catch-all이 켜져 있으면 새 주소는 catch-all과 같은 서명과 설정으로 시작합니다.
계정용으로 예약된 주소는 409 address_reserved로, 주소 한도에 도달한 워크스페이스는 422 workspace_limit_reached로 응답합니다.
