Contacts

Count Contacts

Returns the total contact count for the host.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

GET/v1/contacts/count

curl -X GET "https://api.3common.com/v1/contacts/count" \
  -H "Authorization: Bearer <token>"

Default Response

Response

{
  "data": {
    "count": -9007199254740991
  }
}

TypeScript

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

Create Contact

Creates a new contact. Fails with 409 if a contact with the same email already exists for the host — callers wanting "create or fetch existing" behaviour should use the host management site upsert flow instead.

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.