AckdbContactIdentityLink

Maps an external ID to a contact (#310). One contact can have many links across many sources. Contact writes only accept REGISTERED universal link types (never per-source-declared types) — see POST /schemas/identity-link-types.

Properties

contactIdstringrequired

The contact this link belongs to.

sourcestringrequired

Source system. Manual writes via this API are always stamped 'manual'.

externalIdTypestringrequired

Type of external ID (e.g. slack_user_id_custom). Never 'domain' — company-grain.

externalIdValuestringrequired

The actual external ID value.

confidencenumberrequiredmin 0 · max 1

Confidence score of the link (0-1). 1.0 = verified.

linkedAtstring <date-time>required

When this identity link was created.

Example

AckdbContactIdentityLink example

{
  "contactId": "01HXYZ123456789ABCDEFGH",
  "source": "manual",
  "externalIdType": "slack_user_id_custom",
  "externalIdValue": "U123456",
  "confidence": 1,
  "linkedAt": "1970-01-01T00:00:00.000Z"
}