Contacts

Create Contact Column

Create a custom contact column. Global if list_id is null, list-scoped otherwise.

Optionally pass an enrichment block to provision a companion waterfall pipeline in the same request — STRONGLY RECOMMENDED so the UI 'Enrich' button works out-of-the-box. Without it the column is created but isn't enrichable until a pipeline is provisioned via POST /enrichment/waterfall/configs.

post/contacts/columns/create

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

titlestring required

Column title shown in the UI (e.g. 'Lead Score')

data_type'text' | 'int' | 'numeric' | 'boolean'

User-selectable dynamic-column data types.

Every member must have a physical type in the repos' pg_type_map (contacts/companies CDP repos + enrichment DynamicColumnRepository: int→INTEGER, numeric→NUMERIC, text→TEXT, boolean→BOOLEAN) and belong to the user-owned family in lists/usecases/dynamic_column_write_contract.py — both already list these four. Write paths coerce values per type via shared.infrustructure.db.cdp.dynamic_column_values.coerce_dynamic_value.

list_idinteger nullable

If set, the column is list-scoped (only visible on that list). Required when enrichment is supplied — waterfall pipelines are list-scoped.

created_bystring email required

Email of the user creating the column (for audit).

Response

Successful Response

Changes

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