Share a 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 share post that references an existing post. Two variants are supported:

Reshare — send message as an empty string ("").
Quote share — send message with your commentary text.

Returns 201 on success. See the request body for field-level semantics, including how to collapse share chains.

x-request-idstring uuid required

Example:9d799e96-a6b9-4883-918c-1fe9ec7ccb8f

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

Required. Set to "" (empty string) for a reshare, or to the commentary text for a quote share. Cannot be null or omitted.

sharedOriginDiscussionstring required

Required. ID of the post being shared.

sharedDiscussionIdstring

Optional. Only set this when sharedOriginDiscussion itself points to a share — it identifies the intermediate share, so the created Post's metadata.share.sharedPost is set to this post and metadata.share.sharedOriginPost to sharedOriginDiscussion, collapsing the chain to a 2-level reference in subsequent reads. Leave unset for first-level shares.

Example request

{
  "sharedOriginDiscussion": "d9020c00-c364-11ee-8080-80005148990b",
  "sharedDiscussionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "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

Share 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

Post type

isSpamboolean

True when the post is classified as spam

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

Edit lifecycle status

v1

Share a post

Headers

Request body

Example request

Response