Skip to main content
POST
Create poll

Authorizations

Authorization
string
header
required

Personal API token — find yours under My Account → API.

Query Parameters

organization_id
string

public_id of an organization the user belongs to. When given, the request runs in that organization context instead of the personal account.

Body

application/json
poll
object
required

Attributes accepted when creating a poll. All settings are passed FLAT under poll (e.g. { "poll": { "title": "...", "allow_comments": true } }) — NOT nested under a settings key, even though the show response groups them under settings for readability.

Response

poll created

public_url
string<uri>
required
member_hash
string
required

Public poll identifier (use for read/submit)

title
string
required
type
string
required
Example:

"Polls::Voting"

status
enum<string>
required
Available options:
active,
closed
admin_url
string<uri> | null

Admin URL (owner/admin access only)

admin_hash
string | null

Admin identifier (only returned to owner)

description
string | null
location
string | null
options_count
integer
voters_count
integer | null
created_at
string<date-time> | null
updated_at
string<date-time> | null
url
string<uri>
settings
object
configuration_hints
object | null

Allowed values for selected configuration fields (owner/admin only)