Skip to main content
POST
Create a custom column on a list

Authorizations

Authorization
string
header
required

Your API token (af_…) as the Basic-auth username, with an empty password.

Path Parameters

listId
string
required

24-character hex id of the list (from GET /business/lists).

Body

application/json
name
string
required

Column name (1-100 characters); unique per list (case-insensitive) or the call answers 409 COLUMN_NAME_TAKEN.

Required string length: 1 - 100
type
enum<string>
default:string

Value type the column stores: string (default), number, date, boolean or url (a {label, value} link).

Available options:
string,
number,
date,
boolean,
url

Response

Success

column
object
required