Bulk upsert contacts for source

POST

/contacts/{sourceId}/bulk-upsert-contacts

Accepts a batch of contact rows and upserts them into the given source (integrations, migrations, or custom loaders).

Path: sourceId identifies the target data source.
Body: contactsData (array of row objects) and optional fieldMapping (same shape as CSV import) to map incoming keys to Highperformr fields.

202 when the batch is accepted for asynchronous processing (depending on server behavior). 400 on validation failures.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Batch accepted for processing.

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/contacts//bulk-upsert-contacts' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contactsData": [],
    "fieldMapping": [
        {
            "sourceFieldName": "example",
            "hpFieldName": "example"
        }
    ]
}'

Response Example

202 - Success

{
    "message": "example"
}

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

Upsert contact into a source

Unique values of one field for a filtered contact set