Skip to main content
POST
/
registrar
/
v1
/
contacts
curl --request POST \
  --url https://www.atom.com/api/registrar/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Jane Doe",
  "email": "jane@example.com",
  "phone": "+1.2025551234",
  "address": "123 Main St",
  "city": "Chicago",
  "state": "IL",
  "zip": "60601",
  "country": "US"
}
'
{
  "success": true,
  "message": "Contact created successfully",
  "data": {
    "handle": "ATOM-12345",
    "type": "registrant_user",
    "label": "My Business Contact",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone": "+1.2025551234",
    "fax": null,
    "organization": "Acme Corp",
    "address": [
      "123 Main St",
      "Suite 400"
    ],
    "city": "Chicago",
    "state": "IL",
    "zip": "60601",
    "country": "US",
    "disclosed_fields": [
      "name",
      "email"
    ],
    "verified": false
  }
}

Authorizations

​
Authorization
string
header
required

Registrar API Bearer token. Obtain from dashboard at /dashboard/seller/api-access after requesting Registrar API access.

Body

application/json
​
email
string<email>
required
Example:

"jane@example.com"

​
phone
string
required
Example:

"+1.2025551234"

​
address
required

Street address as a string or array of lines.

Example:

"123 Main St"

​
city
string
required
Example:

"Chicago"

​
zip
string
required
Example:

"60601"

​
country
string
required

ISO 3166-1 alpha-2 country code (uppercase)

Example:

"US"

​
name
string

Full name. Use either name or first_name + last_name.

Example:

"Jane Doe"

​
first_name
string

First name (alternative to name)

Example:

"Jane"

​
last_name
string

Last name (used with first_name)

Example:

"Doe"

​
fax
string
Example:

"+1.2025559999"

​
organization
string
Example:

"Acme Corp"

​
address_1
string

Address line 1 (alternative to address)

Example:

"123 Main St"

​
address_2
string

Address line 2 (used with address_1)

Example:

"Suite 400"

​
state
string
Example:

"IL"

​
label
string

Optional unique label to identify this contact

Example:

"My Business Contact"

​
disclosed_fields
string[]

WHOIS fields to disclose publicly

Example:
["name", "email"]

Response

Contact created successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Contact created successfully"

​
data
object