Add a lookup column to a list.
Lookup columns are computed, read-only columns whose values are derived live (no writes, no stale data) — e.g. each row’s sequence status or agent conversation count. Adding the same lookup type twice is a no-op that returns the existing column. Discover the available lookup types via GET /lists/actions (entries that carry a lookupType).
Authorizations
Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.
Path Parameters
Body
Lookup column to add
Request body for adding a lookup column — a computed, read-only column whose values are derived live (no writes). Discover available lookup types via GET /lists/actions (entries that carry a lookupType).
The lookup type to add, e.g. "sequence_status" or "agent_conversations". See LOOKUP_TYPE_* constants / GET /lists/actions.
Company ID that owns the list. Required when authenticating with a personal access key (pak_…) — the key is not tied to a specific company so the server cannot infer it. Required when authenticating with a company API key only if the key belongs to a user who has access to multiple companies; otherwise it defaults to the key's company. Optional for JWT (dashboard) auth — defaults to the user's active company.
Response
The created (or existing) lookup column
Response returned after creating a column
The newly-created column

