PATCH

Update Contact

Updates one or more fields on an existing contact.

PATCHhttps://api.vantaxai.com/v1/contacts/{contact_id}

Only include the fields you want to change. Supplying `tags` replaces the contact's full tag set rather than appending to it.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…
Content-Typestringrequired
Must be application/json for requests with a body.
example: application/json

Path Parameters

contact_idstringrequired
The contact to update.
example: ct_9b21d3

Body Parameters

first_namestringoptional
New first name.
last_namestringoptional
New last name.
emailstringoptional
New email address.
phonestringoptional
New phone number in E.164 format.
statusstringoptional
Update the contact's status.
activedeactivated
addressstringoptional
Update the address.
lead_sourcestringoptional
Update the lead source.
tagsstring[]optional
Replace the contact's tag set.

Request

curl -X PATCH https://api.vantaxai.com/v1/contacts/ct_9b21d3 \
  -H "Authorization: Bearer vx_live_3fa9c2..." \
  -H "Content-Type: application/json" \
  -d '{
  "first_name": "string",
  "last_name": "string",
  "email": "string",
  "phone": "string"
}'

const res = await fetch(
  "https://api.vantaxai.com/v1/contacts/ct_9b21d3",
  {
  method: "PATCH",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "phone": "string"
  }),
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// PATCH /v1/contacts/{contact_id}
const result = await vantax.request("PATCH", "/v1/contacts/{contact_id}", {
  "first_name": "string",
  "last_name": "string",
  "email": "string",
  "phone": "string"
});

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# PATCH /v1/contacts/{contact_id}
result = vantax.request("PATCH", "/v1/contacts/{contact_id}", json={"first_name": "string", "last_name": "string", "email": "string", "phone": "string"})

Response

{
  "success": true,
  "message": "Contact updated successfully",
  "data": {
    "id": "ct_9b21d3",
    "first_name": "Jordan",
    "last_name": "Avery",
    "status": "deactivated",
    "tags": ["vip"],
    "updated_at": "2026-02-02T08:12:00Z"
  }
}

{ "success": false, "message": "Contact not found" }

{
  "success": false,
  "message": "Validation failed",
  "errors": [
    { "field": "email", "message": "email must be a valid email address" }
  ]
}