Assert / Upsert

Assert Company

Create or update a company. Matches by domain, then linkedin_url.

put/companies/assert

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

list_idinteger required

Target list ID

domainstring nullable

Company domain (primary match key)

linkedin_urlstring nullable

LinkedIn URL (fallback match key)

namestring nullable
industrystring nullable
employee_countinteger nullable
annual_revenuestring nullable
citystring nullable
statestring nullable
countrystring nullable
websitestring nullable
descriptionstring 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.