Sign in

v1

latestOpenAPI 3.1.02026-07-263788129.7 KB
Contacts

Update a Contact

Updates an existing contact by its contact_id. Any tags list provided replaces the existing tags on the contact.

patch/v1/contacts/{contact_id}

Path parameters

contact_idstring uuid required

Request body

first_namestring nullable

First name of the contact

last_namestring nullable

Last name of the contact

emailstring nullable

Email address of the contact

titlestring nullable

Job title of the contact

phone_numberstring nullable

Phone number of the contact

linkedin_urlstring nullable

LinkedIn profile URL

locationstring nullable

Location of the contact

notesstring nullable

Notes about the contact

do_not_contactboolean nullable

Whether the contact has opted out of outreach

tagsstring[] nullable

Tags for the contact

Example request

{
  "first_name": "Jane",
  "last_name": "Smith",
  "email": "jane@acme.com",
  "title": "VP of Engineering",
  "phone_number": "+1-555-123-4567",
  "linkedin_url": "https://linkedin.com/in/janesmith",
  "location": "San Francisco, CA",
  "notes": "Met at SaaStr 2025"
}

Response

Successful Response

Example response

{
  "data": {
    "id": "con_abc123",
    "account_id": "acc_def456",
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@acme.com",
    "title": "VP of Engineering",
    "phone_number": "+1-555-123-4567",
    "linkedin_url": "https://linkedin.com/in/janesmith",
    "location": "San Francisco, CA",
    "source": "linkedin",
    "notes": "Met at SaaStr 2025",
    "scoring": {
      "heat_score": "Hot"
    },
    "tags": [
      "Interested",
      "Decision Maker"
    ],
    "created_at": "2025-06-15T10:30:00Z",
    "updated_at": "2025-06-15T10:30:00Z"
  }
}