Create or update a prospect contact

POST

/public/v1/imports/contacts

Provider and external ID bind one workspace record. New matching phone/email candidates require review; bind a target_id with expected_version under a new request key. Default preserve_local protects teammate corrections; external permits only newer source timestamps; qonvera ignores incoming fields. Retired identities cannot be recreated. Identity ownership is pinned to the credential and requires support-assisted transfer after key rotation. Imports do not create conversations, opportunities or marketing consent. Customer enquiries use the separate intake workflow. All retries use the same key and body.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Updated or skipped

Bodyapplication/json

🟢201

🟠400

🟠401

🟠403

🟠409

🟠429

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://qonvera-521534438700.europe-west1.run.app/public/v1/imports/contacts' \
--header 'Idempotency-Key: 01K39V4M4A0Q8C8X78QX6P7C2P' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "provider": "string",
    "external_id": "string",
    "source_updated_at": "2019-08-24T14:15:22.123Z",
    "mapping_revision": 0,
    "fields": {},
    "target_id": "d3bcdc92-4191-401b-ad0c-42056c6efab9",
    "expected_version": 1
}'

Response Example

200 - Example 1

{
    "outcome": "created",
    "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
    "candidate_ids": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ],
    "skipped_fields": [
        "string"
    ],
    "data": {},
    "error": {}
}

Modified at 2026-10-01 15:06:15

Update safe contact fields

Read durable workspace changes