Update a contact

Update an existing contact by id.

Endpoint

PUT /api/v1/{subdomain}/contacts/{id}

Required ability: contacts.update.

Headers

Header	Value
`Authorization`	`Bearer <your-64-hex-token>`
`Content-Type`	`application/json`
`Accept`	`application/json`

Path parameters

string

required

Your workspace subdomain.

integer

required

Contact id.

Body parameters

string

required

First name. Max 255 characters.

string

required

Last name. Max 255 characters. Required on update.

string

required

Phone number. Max 20 characters. Unique per workspace.

string

required

lead or customer.

string

Max 191 characters. Unique per workspace when provided.

integer

Id of a Source. Nullable on update.

integer

Id of a Status. Nullable, max 50.

string

Max 255 characters.

string

Freeform description.

integer

Country id.

integer

Owner user id.

string

Comma-separated group names. Missing groups are auto-created.

Example request

curl -X PUT https://dash.xobito.com/api/v1/acme/contacts/451 \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "firstname": "John",
    "lastname": "Doe",
    "phone": "+14155551234",
    "type": "customer",
    "status_id": 3
  }'

const res = await fetch(
  "https://dash.xobito.com/api/v1/acme/contacts/451",
  {
    method: "PUT",
    headers: {
      Authorization: "Bearer <your_token>",
      "Content-Type": "application/json",
      Accept: "application/json",
    },
    body: JSON.stringify({
      firstname: "John",
      lastname: "Doe",
      phone: "+14155551234",
      type: "customer",
      status_id: 3,
    }),
  }
);
const body = await res.json();

import requests

r = requests.put(
    "https://dash.xobito.com/api/v1/acme/contacts/451",
    headers={
        "Authorization": "Bearer <your_token>",
        "Accept": "application/json",
    },
    json={
        "firstname": "John",
        "lastname": "Doe",
        "phone": "+14155551234",
        "type": "customer",
        "status_id": 3,
    },
)
body = r.json()

<?php
$ch = curl_init('https://dash.xobito.com/api/v1/acme/contacts/451');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer <your_token>',
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'firstname' => 'John',
        'lastname'  => 'Doe',
        'phone'     => '+14155551234',
        'type'      => 'customer',
        'status_id' => 3,
    ]),
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);

Example response

200 OK

{
  "status": "success",
  "message": "Contact updated successfully",
  "data": {
    "id": 451,
    "tenant_id": 13,
    "firstname": "John",
    "lastname": "Doe",
    "phone": "+14155551234",
    "email": "john@example.com",
    "type": "customer",
    "source_id": 2,
    "status_id": 3,
    "updated_at": "2026-04-16T13:01:10.000000Z"
  }
}

Error responses

Status	When	Example body
`401`	Missing / invalid token	`{"status":"error","message":"Invalid API token"}`
`403`	Missing ability	`{"status":"error","message":"Token does not have the required ability: contacts.update"}`
`404`	Contact not found	`{"status":"error","message":"Contact not found"}`
`422`	Validation	`{"status":"error","message":"Validation failed","errors":{"lastname":["The lastname field is required."]}}`
`429`	Rate limit	`{"message":"Too many requests","retry_after":45}`
`500`	Server error	`{"status":"error","message":"Failed to update contact"}`

Introduction

API Reference

Webhooks

Data Types

Update a contact

Endpoint

Headers

Path parameters

Body parameters

Example request

Example response

Error responses

​Endpoint

​Headers

​Path parameters

​Body parameters

​Example request

​Example response

​Error responses

Endpoint

Headers

Path parameters

Body parameters

Example request

Example response

Error responses