Bulk Upsert Contacts

Upserts up to many contacts in one round-trip, deduplicated server-side by email. Partial-safe: scalar fieldsupdate only when supplied, and custom properties merge by property_id (supplied properties are added/overwritten, omitted ones are preserved). Never wipes properties you do not resend.

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 in place: scalar fields (name, phone, status) update only when you supply them, and custom properties merge by property_id — supplied properties are added/overwritten, omitted ones are preserved. Capped at 1000 per request — clients batch larger imports.

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;
  };
}