curl --request POST \
  --url https://{your-subdomain}.neetodesk.com/api/external/v2/customers \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "customer": {
    "emails": [
      "john@example.com",
      "jane@example.com"
    ],
    "first_name": "John",
    "last_name": "Doe",
    "phones": [
      "+1234567890"
    ],
    "links": [
      "https://github.com/john"
    ],
    "language": "English",
    "time_zone": "Eastern Time (US & Canada)",
    "description": "VIP customer",
    "company_id": "aaaabbbb-cccc-dddd-eeee-ffff00001111"
  }
}
'

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customer: {
      emails: ['john@example.com', 'jane@example.com'],
      first_name: 'John',
      last_name: 'Doe',
      phones: ['+1234567890'],
      links: ['https://github.com/john'],
      language: 'English',
      time_zone: 'Eastern Time (US & Canada)',
      description: 'VIP customer',
      company_id: 'aaaabbbb-cccc-dddd-eeee-ffff00001111'
    }
  })
};

fetch('https://{your-subdomain}.neetodesk.com/api/external/v2/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{your-subdomain}.neetodesk.com/api/external/v2/customers"

payload = { "customer": {
        "emails": ["john@example.com", "jane@example.com"],
        "first_name": "John",
        "last_name": "Doe",
        "phones": ["+1234567890"],
        "links": ["https://github.com/john"],
        "language": "English",
        "time_zone": "Eastern Time (US & Canada)",
        "description": "VIP customer",
        "company_id": "aaaabbbb-cccc-dddd-eeee-ffff00001111"
    } }
headers = {
    "X-Api-Key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "customer": {
    "id": "aaaabbbb-cccc-dddd-eeee-ffff00002222",
    "name": "John Doe",
    "email": "john@example.com",
    "language": "English",
    "time_zone": "Eastern Time (US & Canada)",
    "description": "VIP customer",
    "created_at": "2026-09-01T10:15:30.000Z",
    "updated_at": "2026-09-03T08:42:11.000Z",
    "emails": [
      "john@example.com",
      "john.doe@work.example.com"
    ],
    "phone_numbers": [
      "+1234567890"
    ],
    "company": {
      "id": "aaaabbbb-cccc-dddd-eeee-ffff00001111",
      "name": "Acme Inc."
    }
  }
}