Skip to main content
POST
/
domains
/
import
Importing a domain to Cloudflare
curl --request POST \
  --url https://api.peeker.ai/api/partner/v1/domains/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domains": [
    "<string>"
  ]
}
'
{
  "data": {
    "id": "imp_01HZX0IM1A2B3C4D5E6F7G8H",
    "status": "in_progress",
    "submitted_count": 2,
    "completed_count": 0,
    "failed_count": 0,
    "nameserver_groups": [
      {
        "nameserver_one": "helena.ns.cloudflare.com",
        "nameserver_two": "idris.ns.cloudflare.com",
        "domains": [
          "acme-mail.com",
          "team-acme.com"
        ]
      }
    ],
    "failed": [
      {
        "domain": "bad-acme.com",
        "reason": "cloudflare_import_failed"
      }
    ],
    "created_at": "2026-05-08T12:00:00Z",
    "completed_at": "2026-05-08T12:05:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.peeker.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
default:Bearer pk_test_<your-test-key>
required

Your partner API key. Use pk_live_… against the live system or pk_test_… against the sandbox.

Body

application/json
domains
string[]
required
Maximum array length: 25

Response

200 - application/json

Import finished (success or per-domain failures surfaced in the job).

data
object
required
Last modified on May 14, 2026