- Zapmail Docs
- users
- workspaces
- billing
- mailbox
- payments & wallet
- export
- subscriptions
- domains
- Retrieve All Domains
- List Assignable Domains
- Add DMARC record
- Add Domain forwarding
- Get Name servers to connect domain
- Verify Name Server Propagation
- Connect Domain with Zapmail
- Enable email forwarding
- Remove email forwarding
- Enable catch all emails
- Remove catch all emails
- Check DNS records
- Remove unused domains
- Get available domains for registration
- Get domains purchase payment link
- Get domain connection requests
- Remove domain connection requests
- Connect Domain with Zapmail (New)
- Add Google Client ID to Domain
- Get availability of multiple domain names.
- Retrieve Domain Health Score
- Retrieve All Domains (With filters)
- dns
- aged domains
- prewarmed domains
- placement test
- dns shield
- Schemas
Add dns records
POST
/v2/dns
| Name | Type | Description |
|---|---|---|
assignedDomainId | string | The unique identifier for the domain to which DNS records are assigned. (domainId) |
records | array | A list of DNS records associated with the domain. |
records Array Structure#
| Name | Type | Description |
|---|---|---|
host | string | The domain or subdomain for which the DNS record applies. |
value | string | The corresponding value of the DNS record, such as an IP address or another domain. |
recordType | string | The type of DNS record (e.g., A, CNAME, MX, TXT). |
Request
Header Params
Body Params application/json
Example
{
"assignedDomainId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"records": [
{
"host": "@",
"value": "203.0.113.1",
"recordType": "A"
},
{
"host": "blog",
"value": "example.com",
"recordType": "CNAME"
},
{
"host": "_dmarc",
"value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com",
"recordType": "TXT"
},
{
"host": "@",
"value": "2001:db8::1",
"recordType": "AAAA"
}
]
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.zapmail.ai/api/v2/dns' \
--header 'x-auth-zapmail;' \
--header 'x-workspace-key;' \
--header 'x-service-provider;' \
--header 'Content-Type: application/json' \
--data-raw '{
"assignedDomainId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"records": [
{
"host": "@",
"value": "203.0.113.1",
"recordType": "A"
},
{
"host": "blog",
"value": "example.com",
"recordType": "CNAME"
},
{
"host": "_dmarc",
"value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com",
"recordType": "TXT"
},
{
"host": "@",
"value": "2001:db8::1",
"recordType": "AAAA"
}
]
}'Responses
🟢200Success
application/json
Body
Example
{
"status": 200,
"message": "Dns records added successfully",
"data": [
{
"id": "11111111-1111-1111-1111-111111111111",
"value": "123.123.123.123",
"host": "dummy.com",
"recordType": "A",
"assignedDomainId": "22222222-2222-2222-2222-222222222222",
"cdfRecordId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"cdfResponse": {
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"name": "dummy.com.dns-records.test",
"type": "A",
"content": "123.123.123.123"
},
"priority": null,
"createdAt": "2025-01-31T09:03:21.984Z",
"updatedAt": "2025-01-31T09:03:21.984Z",
"deletedAt": null
},
{
"id": "33333333-3333-3333-3333-333333333333",
"value": "dummy-mailserver.com",
"host": "mail.dummy.com",
"recordType": "CNAME",
"assignedDomainId": "22222222-2222-2222-2222-222222222222",
"cdfRecordId": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"cdfResponse": {
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"name": "mail.dummy.com.dns-records.test",
"type": "CNAME",
"content": "dummy-mailserver.com"
},
"priority": null,
"createdAt": "2025-01-31T09:03:21.984Z",
"updatedAt": "2025-01-31T09:03:21.984Z",
"deletedAt": null
}
]
}🟠400Not registered
Modified at 2025-10-14 09:23:55