Upsert contact into a source

POST

/contacts/{id}

Creates or updates a contact scoped to a data source (import, integration, or webhook source).

Path: the path parameter is the source id (which source owns this row). The server loads source configuration (for example field mapping) and may transform the payload before save.

Body: typically raw lead fields or webhook payload; optional _ORIGIN_ may be set for tracing. For mapped imports, columns are translated via the source’s mapping.

Note: This route shares the /{id} path template with GET/PATCH/DELETE contact-by-id; at runtime POST is registered as POST /:sourceId so the segment here is the source id, not the contact id.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/contacts/' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "_ORIGIN_": "csv_import",
    "contact.workEmail": "jamie.rivera@acme.io",
    "contact.firstName": "Jamie"
}'

Response Example

200 - Success

{
    "data": {
        "id": "cnt_7f3k9m2pqx",
        "firstName": "Jamie",
        "lastName": "Rivera",
        "fullName": "Jamie Rivera",
        "title": "Staff Software Engineer",
        "linkedIn": "https://www.linkedin.com/in/jamie-rivera-example",
        "emails": [
            "jamie.rivera@acme.io"
        ],
        "sources": [
            "src_csv_import_2025_01"
        ],
        "companies": [
            "cmp_4n8k2j1w"
        ],
        "primaryCompanyId": "cmp_4n8k2j1w",
        "company": {
            "id": "cmp_4n8k2j1w",
            "companyName": "Acme Analytics Inc",
            "companyWebsite": "https://www.acme.io",
            "companyIndustry": "Computer Software",
            "companyHeadcount": "201-500"
        },
        "createdAt": "2025-03-12T14:22:11.000Z",
        "updatedAt": "2025-04-08T09:01:44.000Z"
    }
}

Modified at 2026-04-22 07:54:17

Delete contact

Bulk upsert contacts for source