Skip to main content
PATCH
/
contacts
/
{contactId}
curl -X PATCH \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Janet", "job_title": "CTO", "tags": ["vip", "speaker"]}' \
  "https://www.gomry.com/api/v1/contacts/AbCdEfGhIjKlMnOpQrSt"

{
  "data": {
    "id": "AbCdEfGhIjKlMnOpQrSt",
    "first_name": "Janet",
    "last_name": "Doe",
    "email": "jane@example.com",
    "phone_number": "+1234567890",
    "status": "active",
    "job_title": "CTO",
    "company": "Acme Inc",
    "university": null,
    "gender": null,
    "birthday": null,
    "location": "New York",
    "linkedin": null,
    "instagram": null,
    "twitter": null,
    "github": null,
    "website": null,
    "tags": ["vip", "speaker"],
    "created_at": "2025-03-01T00:00:00.000Z",
    "updated_at": "2025-07-15T10:30:00.000Z"
  }
}

​
Update Contact

Updates an existing contact. Only provided fields are modified — omitted fields remain unchanged. The request body uses strict validation: unknown fields (e.g., organizationID) are rejected with a 400 error to prevent accidental data corruption.

​
Path Parameters

​
contactId
string
required
The unique identifier of the contact.

​
Request Body

All fields are optional. Only include the fields you want to update. Set a field to null to clear it.
​
email
string
Email address. Will be normalized to lowercase. If the new email is already used by another contact in your organization, the request returns 409 Conflict.
​
phone_number
string
Phone number.
​
first_name
string
First name.
​
last_name
string
Last name.
​
job_title
string | null
Job title. Set to null to clear.
​
company
string | null
Company name. Set to null to clear.
​
university
string | null
University name. Set to null to clear.
​
gender
string | null
Gender. Set to null to clear.
​
birthday
string | null
Birthday. Set to null to clear.
​
location
string | null
Location. Set to null to clear.
​
linkedin
string | null
LinkedIn URL.
​
instagram
string | null
Instagram handle.
​
twitter
string | null
Twitter handle.
​
github
string | null
GitHub handle.
​
website
string | null
Website URL.
​
tags
string[]
Replace the contact’s tags with this array.
​
status
string
Contact status. Allowed values: active, inactive.

​
Response

Returns the updated contact object.
​
data
object
The updated contact object (same schema as Get Contact).
curl -X PATCH \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Janet", "job_title": "CTO", "tags": ["vip", "speaker"]}' \
  "https://www.gomry.com/api/v1/contacts/AbCdEfGhIjKlMnOpQrSt"

{
  "data": {
    "id": "AbCdEfGhIjKlMnOpQrSt",
    "first_name": "Janet",
    "last_name": "Doe",
    "email": "jane@example.com",
    "phone_number": "+1234567890",
    "status": "active",
    "job_title": "CTO",
    "company": "Acme Inc",
    "university": null,
    "gender": null,
    "birthday": null,
    "location": "New York",
    "linkedin": null,
    "instagram": null,
    "twitter": null,
    "github": null,
    "website": null,
    "tags": ["vip", "speaker"],
    "created_at": "2025-03-01T00:00:00.000Z",
    "updated_at": "2025-07-15T10:30:00.000Z"
  }
}