Skip to main content
POST
Create a new custom field

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

network_id
required

The Network's unique integer ID, or subdomain Unique numeric network ID

Body

application/json

Submit results as JSON

Request body for creating a custom field

title
string
required

The title of the custom field

Example:

"Favorite Color"

response_type
string
required

The type of response this custom field accepts (dropdown_single_select, dropdown_multi_select, text_short, text_long)

Example:

"dropdown_single_select"

privacy
string
required

Privacy level of the custom field (public, private, admin)

Example:

"public"

response_by
string
required

Who can respond to this custom field (hosts_only, individual_member)

Example:

"individual_member"

description
string

Description of the custom field

Example:

"Select your favorite color"

placeholder
string

Placeholder text for the custom field input

Example:

"Enter your answer here"

allow_ad_hoc
boolean

Whether members can add their own options (for dropdown types)

max_responses
integer<uint64>

Maximum number of selections allowed (for dropdown_multi_select, between 2 and 40)

Example:

5

options
string[]

Array of option texts for dropdown types

Response

The created custom field object

Custom Fields are configurable fields that can be added to capture additional member information

id
integer<uint64>
required

The record's integer ID

Example:

"1234"

created_at
string<date-time>
required

The date and time the record was created

Example:

"2026-08-13T00:16:13+00:00"

updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2026-08-13T00:16:13+00:00"

title
string
required

The title of the custom field

Example:

"Favorite Color"

response_type
string
required

The type of response this custom field accepts

Example:

"dropdown_single_select"