ContactsUpdate contact

Update contact

Requires contacts:write. Requires If-Match and Idempotency-Key. Omitted fields remain unchanged. Returns persisted confirmation, not the full detail. Primary email and mobile are read-only. Omit both from PATCH bodies, including unchanged values and nulls. Supplying either returns 422 CONTACT_IDENTITY_READ_ONLY without applying any changes. Reading and filtering remain supported.

curl -X PATCH "https://app.inrepli.com/v1/contacts/example_string" \
  -H "Content-Type: application/json" \
  -H "If-Match: example_string" \
  -H "Idempotency-Key: example_string" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "position": "Manager",
  "notes": "Requested a follow-up."
}'
{
  "data": {
    "id": "example-id-2",
    "name": "Example contact",
    "firstName": null,
    "lastName": null,
    "email": "contact@example.test",
    "mobile": null,
    "position": "Manager",
    "company": null,
    "companyId": null,
    "ownerId": null,
    "qualification": true,
    "createdAt": "2026-09-09T06:34:58.379Z",
    "updatedAt": "2026-09-09T06:34:58.895Z",
    "notes": "Requested a follow-up.",
    "etag": ""2026-09-09T06:34:58.895Z"",
    "location": {
      "country": null,
      "region": null,
      "city": null
    },
    "customFields": {
      "segment": "enterprise"
    }
  }
}
PATCH
/contacts/{id}
PATCH
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Tenant API key beginning with inr_v1_.

Tenant API key beginning with inr_v1_.
Content-Typestring
Required

The media type of the request body

Options: application/json
header
If-Matchstring
Required

Use the quoted etag from a list item, detail or previous PATCH. Missing: 428; stale: 412. Read is not implied by write.

header
Idempotency-Keystring
Required

Use a unique key for each logical update. Retry the exact body, resource and If-Match with the same key. Stored response expires after 24 hours; reuse with a different request during retention returns 409.

Min length: 1 • Max length: 255
customFieldsobject

Active custom definition keys. Omitted keys remain unchanged; null clears a value. Select values use options[].value from definitions (valueKey), never option IDs. DECIMAL requires an exact string (20 integer and 10 fractional digits maximum). DATE uses YYYY-MM-DD; DATETIME uses an ISO timestamp. Updating values requires the resource write scope and current customFieldsEditable plan eligibility, not custom-fields:read.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Tenant API key beginning with inr_v1_.

Path Parameters

Headers

If-Matchstring
Required

Use the quoted etag from a list item, detail or previous PATCH. Missing: 428; stale: 412. Read is not implied by write.

Idempotency-Keystring
Required

Use a unique key for each logical update. Retry the exact body, resource and If-Match with the same key. Stored response expires after 24 hours; reuse with a different request during retention returns 409.

Body

application/json
locationobject
customFieldsobject

Active custom definition keys. Omitted keys remain unchanged; null clears a value. Select values use options[].value from definitions (valueKey), never option IDs. DECIMAL requires an exact string (20 integer and 10 fractional digits maximum). DATE uses YYYY-MM-DD; DATETIME uses an ISO timestamp. Updating values requires the resource write scope and current customFieldsEditable plan eligibility, not custom-fields:read.

Responses

dataobject

Compact persisted confirmation. Core fields and all active custom values are returned; notes/language/timezone/industry appear only when submitted. This is not a full detail response.