v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Social Feeds

Create a poll post

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.


Creates a new poll post. The poll must include a title and at least 2 options. Once created the poll is immutable — options and title cannot be changed. The post itself can still be deleted.

post/api/v1/posts/polls

Headers

x-request-idstring uuid required
Example:0a686e26-897d-4643-9f22-6f1d84776096

A unique request identifier.

x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Request body

messagestring required

Text content of the post (max 1000 chars)

Example request

{
  "message": "Where do you think $TSLA will be in 6 months?",
  "poll": {
    "title": "TSLA price target in 6 months?",
    "options": [
      {
        "text": "Above $300",
        "index": 1
      }
    ]
  },
  "attachments": [
    {
      "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
      "title": "Tesla Q4 Earnings Chart",
      "host": "cdn.etoro.com",
      "description": "Tesla quarterly earnings breakdown",
      "mediaType": "Image",
      "media": {
        "image": {
          "width": 1200,
          "height": 630,
          "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
        }
      }
    }
  ]
}

Response

Poll post created

idstring

Unique post ID

obsoleteIdstring

Legacy numeric post ID

createdstring date-time

Creation timestamp

updatedstring date-time nullable

Last-edited timestamp

isDeletedboolean

True when the post has been soft-deleted

type'Default' | 'Share' | 'MarketEvent' | 'Trade' | 'Order' | 'Copy' | 'Poll' | 'Article'

Post type

isSpamboolean

True when the post is classified as spam

editStatus'None' | 'Edited' | 'Moderated'

Edit lifecycle status