Bulk Upsert Contacts

Upserts up to many contacts in one round-trip. Deduplicated server-side by email.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Request Body

application/jsonRequired

contactsRequiredarray<object>

Contacts to upsert, deduped server-side by email. Existing rows are updated (not just inserted) so re-imports refresh the persisted fields.

POST/v1/contacts/bulk

curl -X POST "https://api.3common.com/v1/contacts/bulk" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {
        "email": "string",
        "firstName": "string",
        "lastName": "string",
        "phone": "string",
        "status": "deleted",
        "properties": [
          {
            "property_id": "string",
            "value": "string"
          }
        ],
        "eventsAttended_IDS": [
          "string"
        ],
        "itemsPurchased_IDS": [
          "string"
        ],
        "productsPurchased_IDS": [
          "string"
        ],
        "property1": null,
        "property2": null
      }
    ]
  }'

Default Response

Response

{
  "data": {
    "affected": -9007199254740991
  }
}

TypeScript

export interface Response {
  data: {
    affected: number;
  };
}