Contacts

Update a Contact

Changed on

Updates an existing contact by its contact_id.

patch/v1/contacts/{contact_id}

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/contacts/{contact_id}
  • Auth
    none declared

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 (a linkedin.com/in/... URL)

notesstring nullable

Notes about the contact

do_not_contactboolean nullable

Whether the contact has opted out of outreach

tagsstring[] nullable

Tag IDs for the contact. Replaces the contact's existing tags.

Example request

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

Response

Successful Response

Example response

{
  "data": {
    "id": "con_abc123",
    "account_id": "acc_def456",
    "account_name": "Acme Corp",
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@acme.com",
    "title": "VP of Engineering",
    "phone_number": "+1-415-555-0132",
    "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",
    "last_activity_at": "2025-06-15T10:30:00Z",
    "last_activity_type": "outbound_email",
    "last_outbound_at": "2025-06-15T10:30:00Z",
    "last_outbound_type": "email",
    "last_inbound_at": "2025-06-15T10:30:00Z",
    "last_inbound_type": "email"
  }
}

Changes

    • warning

      removed the request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status