Skip to main content
PATCH
/
v1
/
preview
/
contacts
/
{contact_id}
Update Contact
curl --request PATCH \
  --url https://api.example.com/v1/preview/contacts/{contact_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "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",
  "do_not_contact": true,
  "tags": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'
{
  "data": {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "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",
    "do_not_contact": false,
    "notes": "Met at SaaStr 2025",
    "scoring": {
      "heat_score": "Hot"
    },
    "tags": [
      "<string>"
    ]
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.monaco.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

contact_id
string<uuid>
required

Body

application/json

Request body for updating a contact via PATCH.

first_name
string | null

First name of the contact

Example:

"Jane"

last_name
string | null

Last name of the contact

Example:

"Smith"

email
string | null

Email address of the contact

Example:

"jane@acme.com"

title
string | null

Job title of the contact

Example:

"VP of Engineering"

phone_number
string | null

Phone number of the contact

Example:

"+1-555-123-4567"

linkedin_url
string | null

LinkedIn profile URL

Example:

"https://linkedin.com/in/janesmith"

location
string | null

Location of the contact

Example:

"San Francisco, CA"

notes
string | null

Notes about the contact

Example:

"Met at SaaStr 2025"

do_not_contact
boolean | null

Whether the contact has opted out of outreach

tags
string<uuid>[] | null

Tags for the contact

Response

Successful Response

data
ContactResponse · object
required

Contact resource. Custom fields appear as additional keys prefixed with custom_field_.

meta
ResponseMeta · object