AckdbContactMappingInput

Maps event content fields to a contact (person) extracted at ingest time. Used for person-scope events that mention an individual (name, email, title).

Properties

rolestringrequired

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

nameFieldstringrequired

Content field holding the contact's name.

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
}