Update a Contact - Leadfeeder API

Update a contact.

Applies a partial (merge-patch) update to the contact: only the attributes named in the request are changed; any attribute you omit is left untouched. This endpoint updates the contact's custom field values.

To set custom field values, send them under attributes.custom_fields, keyed by custom field id. The value type is inferred from the field definition — no type is sent in the request. Only simple field types may be set: text, number, boolean, and date. Prompt-capable / computed types (ai_*, contact_collection) and unknown custom field ids are rejected with 400. The updated values are returned inside the entity's data envelope.

The request is validated strictly and applied atomically: if any field fails validation, the whole request is rejected and nothing is written. Per-field errors carry a source.pointer locating the offending field; when fields fail with different statuses, the response status is the most severe one (403 over 400). Sending null as a value clears that field (merge-patch delete); clearing a field with no stored value is a no-op. A maximum of 100 custom fields may be supplied per request.

Credit Note: Updating a contact does not consume credits.

INFO

Requires the custom_fields:write OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Path Params

Query Params

Body Params application/jsonRequired

Example

{
    "data": {
        "type": "contact",
        "attributes": {
            "custom_fields": {
                "contact_lead-score": {
                    "value": 42
                },
                "contact_is-decision-maker": {
                    "value": true
                },
                "contact_notes": {
                    "value": "Met at trade fair"
                }
            }
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Contact updated

Bodyapplication/json

Example

{
    "data": {
        "id": "456",
        "type": "contact",
        "attributes": {
            "custom_fields": {
                "contact_lead-score": {
                    "value": 42
                },
                "contact_is-decision-maker": {
                    "value": true
                },
                "contact_notes": {
                    "value": "Met at trade fair"
                }
            }
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🟠429

🔴500Server Error

🔴504Gateway Timeout