API Reference
이메일 발신 도메인 등록
발신에 사용할 도메인을 등록하고, 소유 증명에 필요한 DNS 레코드(CNAME 3건)를 받습니다.
등록만으로는 발신할 수 없습니다. 응답의 dnsRecords 3건을 도메인 DNS 에 심은 뒤
검증 API 를 호출해야 verified 가 됩니다. DNS 전파에는 보통 수 분~수 시간이 걸립니다.
멱등입니다. 같은 계정이 같은 도메인을 다시 등록하면 새 리소스를 만들지 않고 기존 항목을
200 으로 돌려줍니다. 새로 등록된 경우에만 201 입니다.
⚠️ 한 도메인은 ClawOps 전체에서 한 계정만 소유합니다. 다른 계정이 이미 등록했다면 409 입니다.
단, 등록만 해두고 72시간 동안 소유를 증명하지 않은 도메인은 회수되어 다른 계정이 등록할 수
있습니다 — 등록 후에는 DNS 를 설정하고 검증까지 마치세요.
루트 도메인과 하위 도메인은 별개입니다. example.com 과 mail.example.com 을 모두 쓰려면
각각 등록해야 합니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/email-domains" \ -H "Content-Type: application/json" \ -d '{ "domain": "mail.example.com" }'{
"id": "clx9edm00001",
"domain": "mail.example.com",
"status": "pending",
"dnsRecords": [
{
"purpose": "dkim",
"requirement": "required",
"type": "CNAME",
"name": "abc123._domainkey.mail.example.com",
"value": "abc123.dkim.amazonses.com",
"priority": null
}
],
"receivingEnabled": false,
"receivingStatus": null,
"receivingCheckedAt": null,
"mailFromStatus": null,
"dmarcStatus": null,
"lastCheckedAt": "2026-09-02T00:00:00.000Z",
"verifiedAt": null,
"pendingExpiresAt": "2026-09-05T00:00:00.000Z",
"createdAt": "2026-09-02T00:00:00.000Z",
"updatedAt": "2026-09-02T00:00:00.000Z"
}{
"id": "clx9edm00001",
"domain": "mail.example.com",
"status": "pending",
"dnsRecords": [
{
"purpose": "dkim",
"requirement": "required",
"type": "CNAME",
"name": "abc123._domainkey.mail.example.com",
"value": "abc123.dkim.amazonses.com",
"priority": null
}
],
"receivingEnabled": false,
"receivingStatus": null,
"receivingCheckedAt": null,
"mailFromStatus": null,
"dmarcStatus": null,
"lastCheckedAt": "2026-09-02T00:00:00.000Z",
"verifiedAt": null,
"pendingExpiresAt": "2026-09-05T00:00:00.000Z",
"createdAt": "2026-09-02T00:00:00.000Z",
"updatedAt": "2026-09-02T00:00:00.000Z"
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}