Skip to main content
PUT
/
registrar
/
v1
/
contacts
/
{handle}
Update a contact
curl --request PUT \
  --url https://www.atom.com/api/registrar/v1/contacts/{handle} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Jane Smith",
  "first_name": "Jane",
  "last_name": "Smith",
  "email": "jane.smith@example.com",
  "phone": "+1.2025559876",
  "fax": null,
  "organization": "Acme Corp",
  "address": [
    "456 Oak Ave",
    "Floor 2"
  ],
  "city": "Austin",
  "state": "TX",
  "zip": "78701",
  "country": "US",
  "label": "Updated Label",
  "disclosed_fields": [
    "name"
  ]
}
'
{
  "success": true,
  "message": "Contact updated 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.

Path Parameters

​
handle
string
required

The registrar contact handle to update (e.g. ATOM-12345 or CONTACT_1-67890)

Body

application/json

All fields are optional — only provide the fields you want to change.

​
name
string
Example:

"Jane Smith"

​
first_name
string
Example:

"Jane"

​
last_name
string
Example:

"Smith"

​
email
string<email>
Example:

"jane.smith@example.com"

​
phone
string
Example:

"+1.2025559876"

​
fax
string
Example:

null

​
organization
string
Example:

"Acme Corp"

​
address
Example:
["456 Oak Ave", "Floor 2"]
​
city
string
Example:

"Austin"

​
state
string
Example:

"TX"

​
zip
string
Example:

"78701"

​
country
string
Example:

"US"

​
label
string
Example:

"Updated Label"

​
disclosed_fields
string[]
Example:
["name"]

Response

Contact updated successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Contact updated successfully"

​
data
object