API Reference
이메일 도메인 수신 설정
이 도메인으로 메일을 받을지를 켜고 끕니다. 지금 이 API 로 바꿀 수 있는 것은
receivingEnabled 하나입니다.
켜기 전에 알아야 하는 것
status가verified인 도메인만 켤 수 있습니다(아니면422). 검증 전에는 우리에게 닿기도 전에 메일이 거절됩니다.- 켜면 응답의
dnsRecords에 수신용 MX 1건이 나타납니다. 그 레코드를 심어야 실제로 수신됩니다. 심은 뒤 수신 확인 API 로 제대로 걸렸는지 확인하세요. - ⛔ 루트 도메인(example.com)에 MX 를 얹으면 그 도메인의 모든 메일이 ClawOps 로 옵니다.
Google Workspace·Microsoft 365 를 쓰고 있다면 업무 메일이 끊깁니다. 수신 전용
하위 도메인(예:
reply.example.com)을 따로 등록해서 켜는 것을 권합니다.
끌 때 알아야 하는 것
⚠️ 끄는 것은 우리 쪽 라우팅만 멈춥니다. MX 를 그대로 두면 메일은 계속 ClawOps 에 도착하고, 우리는 그것을 버립니다 — 수신 요금은 청구됩니다. 수신을 그만두려면 MX 도 함께 지우세요.
멱등입니다. 이미 같은 값이면 아무것도 바꾸지 않고 현재 상태를 돌려줍니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
emailDomainId*string
도메인 리소스 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
receivingEnabled*boolean
이 도메인으로 메일을 받을지 여부.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/accounts/AC1a2b3c4d/email-domains/clx9edm00001" \ -H "Content-Type: application/json" \ -d '{ "receivingEnabled": true }'{
"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·대표번호만 발급됩니다."
}
]
}