Update Contact

PUT /external/v1/contacts/:id

Updates an existing contact. Only provided fields will be updated.

Authentication

Requires contacts:write permission.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The unique identifier of the contact

Request Body

All fields are optional. Only include fields you want to update.

Field	Type	Description
name	string	Full name of the contact
email	string	Email address
phone	string	Phone number
company	string	Company name
title	string	Job title/position
location	string	Location
linkedin_profile_url	string	LinkedIn profile URL
tags	array	Array of tag IDs (UUIDs) — replaces existing tags
custom_fields	object	Custom field key-value pairs

Request

cURL

curl --request PUT \
  --url "https://app.getraze.com/external/v1/contacts/cnt_abc123def456" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "title": "VP of Engineering",
    "tags": ["tag_01", "tag_03"]
  }'

Node.js

const axios = require('axios');

const contactId = 'cnt_abc123def456';

const response = await axios.put(
  `https://app.getraze.com/external/v1/contacts/${contactId}`,
  {
    title: 'VP of Engineering',
    tags: ['tag_01', 'tag_03']
  },
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

Python

import requests

contact_id = 'cnt_abc123def456'

response = requests.put(
    f'https://app.getraze.com/external/v1/contacts/{contact_id}',
    headers={
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'title': 'VP of Engineering',
        'tags': ['tag_01', 'tag_03']
    }
)

print(response.json())

Response

{
  "success": true,
  "data": {
    "id": "cnt_abc123def456",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+5511999999999",
    "company": "Acme Inc",
    "title": "VP of Engineering",
    "location": "São Paulo, BR",
    "linkedin_profile_url": "https://linkedin.com/in/johndoe",
    "source": "LinkedIn",
    "custom_fields": {},
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-25T10:00:00Z",
    "tags": [
      { "id": "tag_01", "name": "hot-lead", "color": "red" },
      { "id": "tag_03", "name": "enterprise", "color": "purple" }
    ]
  }
}

Errors

Status	Code	Description
404	NOT_FOUND	Contact not found