Assert / Upsert

Assert Contact

Create or update a contact. Matches by work_email, then linkedin_url.

put/contacts/assert

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/contacts/assert
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

list_idinteger required

Target list ID

work_emailstring nullable

Work email (primary match key)

linkedin_urlstring nullable

LinkedIn URL (fallback match key)

first_namestring nullable
last_namestring nullable
personal_emailsstring nullable
direct_phonestring nullable
mobile_phonestring nullable
job_titlestring nullable
job_departmentstring nullable
seniority_levelstring nullable
citystring nullable
statestring nullable
countrystring nullable
company_domainstring nullable
custom_fieldsobject nullable

Custom column values to write on this record, keyed by the column's display title (e.g. 'Followup 1'), its slug (e.g. 'udo_followup_1_ab12cd34'), or a case/space variant of the title. Keys that match no existing column are reported back in ignored_fields unless create_missing_fields is true.

create_missing_fieldsboolean

When true, any key in custom_fields that matches no existing column is created as a NEW list-scoped custom column (max 100 per request) and then written. Default false preserves the previous behaviour of not creating columns implicitly.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.