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, webhook sources, or custom loaders).

Path: sourceId identifies the target data source.

Body: contactsData (array of row objects). Optional segmentId attaches the source to that audience. Optional webhookConfiguration is notified when the job finishes.

Column mapping is not sent on this request. It is read from the source: sourceMeta.config.fieldMapping set on POST /sources (importFromWebhook). Each sourceFieldName must match a key in contactsData; hpFieldName is a path from GET /schema/contact.

After verified find, create a webhook source with that mapping, then POST selected preview rows here. See bulk upsert contacts.

202 when the batch is accepted for asynchronous processing. Poll jobStatusEndpoint. 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 '{
    "segmentId": "seg_4n2k8j",
    "contactsData": [
        {
            "fullName": "Jamie Rivera",
            "linkedIn": "https://www.linkedin.com/in/jamie-rivera-example",
            "jobTitle": "Chief Executive Officer",
            "companyName": "Acme Analytics",
            "companyWebsite": "acme.com"
        }
    ]
}'

Response Example

202 - Success

{
    "message": "example"
}

Modified at 2026-09-10 06:41:09

Upsert contact into a source

Unique values of one field for a filtered contact set