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"

const response = await fetch(
  "https://www.gomry.com/api/v1/contacts/AbCdEfGhIjKlMnOpQrSt",
  {
    method: "PATCH",
    headers: {
      "X-API-KEY": "your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      first_name: "Janet",
      job_title: "CTO",
      tags: ["vip", "speaker"],
    }),
  }
);
const { data } = await response.json();

{
  "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"
  }
}

{
  "error": "A contact with this email already exists"
}

{
  "error": "Validation failed",
  "details": {
    "formErrors": [],
    "fieldErrors": {}
  }
}

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"

const response = await fetch(
  "https://www.gomry.com/api/v1/contacts/AbCdEfGhIjKlMnOpQrSt",
  {
    method: "PATCH",
    headers: {
      "X-API-KEY": "your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      first_name: "Janet",
      job_title: "CTO",
      tags: ["vip", "speaker"],
    }),
  }
);
const { data } = await response.json();

{
  "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"
  }
}

{
  "error": "A contact with this email already exists"
}

{
  "error": "Validation failed",
  "details": {
    "formErrors": [],
    "fieldErrors": {}
  }
}

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

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.

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.

string

Phone number.

string

First name.

string

Last name.

string | null

Job title. Set to null to clear.

string | null

Company name. Set to null to clear.

string | null

University name. Set to null to clear.

string | null

Gender. Set to null to clear.

string | null

Birthday. Set to null to clear.

string | null

Location. Set to null to clear.

string | null

LinkedIn URL.

string | null

Instagram handle.

string | null

Twitter handle.

string | null

GitHub handle.

string | null

Website URL.

string[]

Replace the contact’s tags with this array.

string

Contact status. Allowed values: active, inactive.

Response

Returns the updated contact object.

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"

const response = await fetch(
  "https://www.gomry.com/api/v1/contacts/AbCdEfGhIjKlMnOpQrSt",
  {
    method: "PATCH",
    headers: {
      "X-API-KEY": "your_api_key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      first_name: "Janet",
      job_title: "CTO",
      tags: ["vip", "speaker"],
    }),
  }
);
const { data } = await response.json();

{
  "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"
  }
}

{
  "error": "A contact with this email already exists"
}

{
  "error": "Validation failed",
  "details": {
    "formErrors": [],
    "fieldErrors": {}
  }
}

Create Contact Delete Contact

Events

Experiences

Recurrences

Attendees

Contacts

Ticket Classes

Forms

Applications

Custom Fields

Lists

Payments

Update Contact

Update Contact

Path Parameters

Request Body

Response

​Update Contact

​Path Parameters

​Request Body

​Response

Update Contact

Path Parameters

Request Body

Response