Skip to main content
POST
/
admin
/
v1
/
networks
/
{network_id}
/
custom_fields
Create a new custom field
curl --request POST \
  --url https://api.mn.co/admin/v1/networks/{network_id}/custom_fields \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Favorite Color",
  "description": "Select your favorite color",
  "placeholder": "Enter your answer here",
  "response_type": "dropdown_single_select",
  "privacy": "public",
  "response_by": "individual_member",
  "allow_ad_hoc": true,
  "max_responses": 5,
  "options": [
    "<string>"
  ]
}'
{
  "id": "1234",
  "created_at": "2025-11-07T23:17:21+00:00",
  "updated_at": "2025-11-07T23:17:21+00:00",
  "title": "Favorite Color",
  "response_type": "dropdown_single_select"
}

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

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
required

The record's integer ID

Example:

"1234"

​
created_at
string<date-time>
required

The date and time the record was created

Example:

"2025-11-07T23:17:21+00:00"

​
updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2025-11-07T23:17:21+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"