1. DNS
  • Litemail Docs
  • Users
    • Retrieve User Details
      GET
  • Workspaces
    • Retrieve All Workspaces
      GET
    • Create New Workspace
      POST
    • Update Workspace
      PUT
  • Billings
    • Add Billing Details
      POST
  • Mailboxes
    • Retrieve Mailboxes
      GET
    • Assign New Mailbox to Domain
      POST
    • Get Mailbox Details
      GET
    • Update Mailbox
      PUT
    • Remove Mailbox (Next Renewal)
      DELETE
  • Payment & Wallet
    • Get Wallet Balance
      GET
    • Add Balance to Wallet
      POST
    • Enable Auto Recharge
      POST
  • Exports
    • Export Mailboxes
      POST
    • Add Third Party Account Details
      POST
    • Update Third Party Account Details
      PUT
  • Subscriptions
    • Get All Subscriptions
      GET
    • Cancel Subscription
      DELETE
    • Upgrade Subscription
      PUT
  • Domains
    • Retrieve Domains
    • List Assignable Domains
    • Add DMARC Records
    • Add Domain Forwarding
    • Remove Domain Forwarding
    • Get Name Servers
    • Verify Name Server Propagation
    • Connect Domains with Zapmail
    • Enable Email Forwarding
    • Remove Email Forwarding
    • Enable Catch-All Emails
    • Remove Catch-All Emails
    • Check DNS Records
    • Remove Unused Domain
    • Get Available Domains for Registration
    • Get Domain Purchase Payment Link
  • DNS
    • Get DNS Records
      GET
    • Add DNS Record
      POST
    • Update DNS Record
      PUT
    • Delete DNS Record
      DELETE
  • apikeys testing
    • generate key by login first
  • Connect Inbox
    • connect-inboxes
  1. DNS

Add DNS Record

POST
/v1/dns
Create a new DNS record for a domain.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw.
Example:
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw ********************
or
Body Params application/jsonRequired

Example
{
    "type": "A",
    "name": "mail",
    "value": "192.0.2.1",
    "ttl": 3600,
    "priority": 10
}

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 '/v1/dns' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImNhdCI6ImNsX0I3ZDRQRDExMUFBQSIsImtpZCI6Imluc18zM1FqbUNRdUNYcU1USUpxeVZvYXVXNUtWckgiLCJ0eXAiOiJKV1QifQ.eyJhenAiOiJodHRwczovL2FwcC5saXRlbWFpbC5haSIsImV4cCI6MTc2OTcyNTc2NSwiZnZhIjpbMCwtMV0sImlhdCI6MTc2OTcyNTcwNSwiaXNzIjoiaHR0cHM6Ly9jbGVyay5saXRlbWFpbC5haSIsIm5iZiI6MTc2OTcyNTY5NSwic2lkIjoic2Vzc18zOHd6dlhoM0N5Vm16a0NsaGk0MWx6WEhoTXciLCJzdHMiOiJhY3RpdmUiLCJzdWIiOiJ1c2VyXzM0aEk2THFBazNPdUlWVDNaZmpuYldRY2pPMiIsInYiOjJ9.2C1vleGX50Q3Z7D1HTH_3xGaTrxnEVwBc1n1EsqZSjQFKriztJXv7VYRUsBRIDH4npejsCcZagNctwS6Hz8tiS_7ggC22UGJbOENmTQCB7V8Ejcl6hC_qH-9Ovmi_6kcmQ9pwT6W4yWSelpm_jDVkDGmGS6GBEsupZYL-FKZpTPGdvlRP0JF8c1U6Z_XaXUH63DHQkcRYMxcQCmZEH7I6jPbyKgUxcL2n7tdBHZcrxAOp5vYlP4Q9aViaVI_ETkDAPm4GqrzL2y5UZKo-mwaiyj4diYX3p1stnHsYgV09MVQny-TCKsoJ_DEukt85GCyWe2SiwA32eCGp5eU-lKnTw <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "A",
    "name": "mail",
    "value": "192.0.2.1",
    "ttl": 3600,
    "priority": 10
}'

Responses

🟢201Created
application/json
DNS record created successfully
Body

Example
{
    "status": 201,
    "message": "DNS record created successfully",
    "data": {
        "id": "dns3",
        "type": "TXT",
        "name": "_verification",
        "value": "abcdef123456",
        "ttl": 3600,
        "createdAt": "2025-10-04T12:00:00Z"
    }
}
Previous
Get DNS Records
Next
Update DNS Record
Built with