AckdbContactMappingInput

Maps event content fields to a contact (person) extracted at ingest time. A durable external ID is required; display name, email, title, and other person properties are optional.

Properties

rolestringrequired

Contact's role for this mapping (e.g. `user`, `attendee`).

nameFieldstring

Optional content field holding the contact's display name. Omit when a durable person key such as LinkedIn URL is the only person data this source owns.

emailFieldstring

Content field holding the contact's email.

titleFieldstring

Content field holding the contact's job title.

externalIdFieldstringrequired

Content field holding the contact's external ID value.

externalIdTypestringrequired

External ID type for the contact (e.g. `app_user_email`).

linkedinUrlFieldstring

Content field holding the contact's LinkedIn URL.

phoneFieldstring

Content field holding the contact's phone number.

departmentFieldstring

Content field holding the contact's department.

excludeWhenobject

Skip extracting this contact when these field/value conditions match.

startedAtFieldstring

Content field holding when the EMPLOYMENT began (#345) — a fact, never inferred from ingest order.

endedAtFieldstring

Content field holding when the employment ENDED (#345); a value flips the edge to `former`.

externalIdScopestring

What `externalIdField` identifies: the HUMAN (a durable person key) or the AFFILIATION (a workspace-local seat id, match-only). Default `affiliation`.

"person""affiliation"

endsPriorboolean

This event asserts the human's OTHER affiliations have ended (job-change semantics): their other active edges flip to `former` with a `contact.ended` each. Person-scope event types only. Default false.

isPrimaryboolean

The resolved edge becomes the person's PRIMARY affiliation (#544, `primarySource: ingest`; sticky while that edge is active). Applied only when the edge is ACTIVE. Person-scope event types only. Default false.

Example

AckdbContactMappingInput example

{
  "role": "string",
  "nameField": "string",
  "emailField": "string",
  "titleField": "string",
  "externalIdField": "string",
  "externalIdType": "string",
  "linkedinUrlField": "string",
  "phoneField": "string",
  "departmentField": "string",
  "excludeWhen": {},
  "startedAtField": "string",
  "endedAtField": "string",
  "externalIdScope": "person",
  "endsPrior": false,
  "isPrimary": false
}