Polls

Create and schedule interactive polls on LinkedIn, Mastodon, and Twitter to engage your audience and gather feedback.

Key Features

• Cross-Platform Polls: One payload to post polls on multiple networks
• Flexible Duration: Support for platform-specific duration limits
• Option Constraints: Enforce character limits and unique choices
• Scheduling: Publish immediately or at a specified time

Supported Platforms & Limits

Network	Question Field	Options	Duration	Editable	Notes
Twitter/X	In text	2–4, ≤25 chars	Up to 7 days	No	Options limit applies across all networks
LinkedIn	Separate question	2–4, ≤30 chars	Up to 14 days	No
Mastodon	In text	2–4, ≤50 chars	Up to 7 days	Yes

Tip: When sending a multi-network poll, adhere to Twitter’s 25-character option limit and common duration (e.g., 1, 3, 7 days).

Request Structure

Use the unified scheduling endpoint:

POST /api/v1/posts/schedule
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "bulk": {
    "state": "scheduled",
    "posts": [{
      "networks": {
        "twitter": {
          "type": "poll",
          "text": "What’s your favorite season?",
          "options": ["Spring", "Summer", "Autumn", "Winter"],
          "duration": 7
        },
        "linkedin": {
          "type": "poll",
          "question": "What’s your favorite season?",
          "text": "Vote now!",
          "options": ["Spring", "Summer", "Autumn", "Winter"],
          "duration": 7
        },
        "mastodon": {
          "type": "poll",
          "text": "What’s your favorite season?",
          "options": ["Spring", "Summer", "Autumn", "Winter"],
          "duration": 7
        }
      },
      "accounts": [
        { "id": "TW_ACCOUNT_ID", "scheduled_at": "2025-06-10T09:00:00Z" },
        { "id": "LI_ACCOUNT_ID", "scheduled_at": "2025-06-10T09:00:00Z" },
        { "id": "MA_ACCOUNT_ID", "scheduled_at": "2025-06-10T09:00:00Z" }
      ]
    }]
  }
}

Parameters

Field	Type	Description
networks.{provider}.type	string	Must be "poll".
networks.{provider}.text	string	Caption or question (Twitter/Mastodon).
networks.linkedin.question	string	Poll question (LinkedIn only).
networks.{provider}.options	string[]	Array of 2–4 unique options.
networks.{provider}.duration	integer	Poll duration in days (platform max limits apply).
accounts[].id	string	Target social account ID.
accounts[].scheduled_at	string	ISO 8601 timestamp for scheduling (omit to publish immediately).

Platform-Specific Notes

Twitter/X

• Options live in options array; question must be in text.
• 2–4 options, ≤25 characters each.
• Cannot edit after publishing.

LinkedIn

• Uses separate question and text.
• Options ≤30 characters.
• Up to 14-day duration.

Mastodon

• Question goes in text.
• Options ≤50 characters.
• Poll can be edited after posting.

Best Practices

• Keep questions clear and concise.
• Use unique, contrasting options.
• Align durations with campaign timelines.

Related Topics

• Text Posts
• Platform-Specific Formats
• Publishing Methods