API reference / CRM
Add a column to a list
Adds one of the list's own columns, at the end: its values live on this list's rows only. With work, it fills itself when it runs: an AI's answer to an ask (any type), or something found (email and contact_email take an email column, verify a select, whose options it sets). At most 100 columns a list.
/api/v1/lists/{id}/columnsOther ways to call it
troopy lists add-columntroopy_add_list_columnIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
id*stringA 24-character id
Body
application/jsonname*stringAt least 1 characters · At most 60 characters
type*enum<string>textnumberdateselectmulti_selecturlcheckboxemailphonelong_text
optionsarray<object>A select's choices
At most 50 items
3 properties
idstringAn existing option's name, to keep or rename it; leave it out to add one
At most 40 characters
name*stringAt least 1 characters · At most 40 characters
colorenum<string>stoneskymintsandrosepeachcyanorange
workobjectMake it a work column, which fills itself when it runs (POST /lists/{id}/columns/{column}/run)
3 properties
kind*"ai"ask*stringWhat to work out for each row, in plain words
At least 1 characters · At most 1000 characters
readbooleanRead each row's website (its home, contact, about and team pages) first
Default false
Response
201 · application/jsondata*object8 properties
id*stringA standard column's field (name, email, title...) or c1, c2... for the list's own
name*stringtype*enum<string>textnumberdateselectmulti_selecturlcheckboxemailphonelong_text
options*array<object>3 properties
id*stringIts name: a select's value is its option's name
name*stringcolor*enum<string>stoneskymintsandrosepeachcyanorange
width*integerhidden*booleanstandard*booleanThe record's own field, the same on every list it is on; it can be hidden, not deleted
work*object | nullWhat it works out when it runs, for a work column; null for the rest
3 properties
kind*"ai"ask*stringWhat to work out for each row, in plain words
At least 1 characters · At most 1000 characters
read*booleanRead each row's website (its home, contact, about and team pages) first
Default false