Skip to main content
POST
/
admin
/
v1
/
networks
/
{network_id}
/
polls
Creates a new poll or question in the network
curl --request POST \
  --url https://api.mn.co/admin/v1/networks/{network_id}/polls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "space_id": 123,
  "title": "<string>",
  "description": "<string>",
  "poll_type": "<string>",
  "choices": [
    "<string>"
  ],
  "notify": true
}'
{
  "id": "1234",
  "created_at": "2025-11-18T17:56:35+00:00",
  "updated_at": "2025-11-18T17:56:35+00:00",
  "post_type": "<string>",
  "poll_type": "<string>",
  "title": "<string>",
  "description": "<string>",
  "creator": {
    "id": "1234",
    "created_at": "2025-11-18T17:56:35+00:00",
    "updated_at": "2025-11-18T17:56:35+00:00",
    "name": "<string>",
    "email": "ada.lovelace@example.com",
    "short_bio": "<string>",
    "admin": true
  },
  "space": {
    "id": "1234",
    "created_at": "2025-11-18T17:56:35+00:00",
    "updated_at": "2025-11-18T17:56:35+00:00",
    "name": "<string>"
  },
  "images": [
    "<string>"
  ],
  "choices": [
    {
      "id": "<string>",
      "text": "<string>"
    }
  ],
  "status": "<string>",
  "published_at": "2025-11-18T17:56:36+00:00",
  "permalink": "<string>",
  "comments_enabled": true,
  "last_activity_at": "2025-11-18T17:56:36+00:00"
}

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 to create a poll or question

​
space_id
integer
required

The ID of the space where the poll will be created

​
title
string
required

The poll question/title

​
poll_type
string
required

The type of poll: 'multiple_choice' (list), 'hot_cold' (continuous slider), 'percentage' (percentage allocation), or 'question' (open-ended text response)

​
description
string

Additional details or context for the poll

​
choices
string[]

Array of choice text strings (required for multiple_choice, hot_cold, and percentage polls)

​
notify
boolean

Whether to notify network members about the new poll

Response

Returns the created poll or question

A poll or question post

​
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-18T17:56:35+00:00"

​
updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2025-11-18T17:56:35+00:00"

​
post_type
string
required

The type of post (poll or question)

​
title
string
required

The poll question/title

​
creator
object
required

The member who created the poll

​
space
object
required

The space where the poll was created

​
status
string
required

The post's current status

​
permalink
string
required

The permanent URL to the poll

​
comments_enabled
boolean
required

Whether or not comments are enabled on this poll

​
poll_type
string

The specific poll type (multiple_choice_poll, hot_cold_poll, percentage_poll)

​
description
string

The full description of the poll

​
images
string[]

Array of image URLs associated with the poll

​
choices
object[]

The poll choices (for polls with choices)

​
published_at
string<date-time>

The date the post was published

Example:

"2025-11-18T17:56:36+00:00"

​
last_activity_at
string<date-time>

The time of last activity on the poll

Example:

"2025-11-18T17:56:36+00:00"