> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # List scheduled Social Selling posts > List the Social Selling posts waiting to be published from the caller’s identities, soonest first, in a publish-time window (default: now to 90 days ahead). Each row has the post text, the publishing identity, the live publish time (`scheduledAt`; null when its schedule is gone and it will not publish) and the pool reactions it gets once live. `publishingPostId` is what `cancel_a_scheduled_social_selling_post` takes. Read-only. Responses include direct Enginy app URLs when available. Each post includes an `appUrl` that opens it in Enginy. MCP agents should return those URLs to users whenever they are present in the response. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 100 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/social-selling/scheduled-posts openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/social-selling/scheduled-posts: get: tags: - Social Selling summary: List scheduled Social Selling posts description: >- List the Social Selling posts waiting to be published from the caller’s identities, soonest first, in a publish-time window (default: now to 90 days ahead). Each row has the post text, the publishing identity, the live publish time (`scheduledAt`; null when its schedule is gone and it will not publish) and the pool reactions it gets once live. `publishingPostId` is what `cancel_a_scheduled_social_selling_post` takes. Read-only. Responses include direct Enginy app URLs when available. Each post includes an `appUrl` that opens it in Enginy. MCP agents should return those URLs to users whenever they are present in the response. > **Required scope:** `SOCIAL_SELLING_READ` > > **Rate limit:** 100 requests per minute parameters: - schema: type: - array - 'null' items: type: integer exclusiveMinimum: 0 minItems: 1 description: >- List of identity ids that publish (REST also accepts a comma-separated value). Defaults to every identity the caller may see; ids outside that scope are ignored. example: 12,34 required: false description: >- List of identity ids that publish (REST also accepts a comma-separated value). Defaults to every identity the caller may see; ids outside that scope are ignored. name: identityIds in: query - schema: anyOf: - type: string format: date-time - type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Only posts publishing at or after this time (a bare date starts at 00:00 UTC). Defaults to now. example: '2026-11-01' required: false description: >- Only posts publishing at or after this time (a bare date starts at 00:00 UTC). Defaults to now. name: from in: query - schema: anyOf: - type: string format: date-time - type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Only posts publishing at or before this time (a bare date ends at 24:00 UTC). Defaults to 90 days after `from`. example: '2026-11-30' required: false description: >- Only posts publishing at or before this time (a bare date ends at 24:00 UTC). Defaults to 90 days after `from`. name: to in: query - schema: type: integer minimum: 1 default: 1 required: false name: page in: query - schema: type: integer minimum: 1 maximum: 50 default: 20 required: false name: pageSize in: query responses: '200': description: Paginated scheduled posts content: application/json: schema: type: object properties: data: type: array items: type: object properties: publishingPostId: type: number description: Pass it to `cancel_a_scheduled_social_selling_post`. identityId: type: - number - 'null' identityName: type: - string - 'null' name: type: - string - 'null' text: type: - string - 'null' scheduledAt: type: - string - 'null' description: >- ISO timestamp it will be published at. Null when its schedule no longer exists: it will not publish (cancel it). reactionsAmount: type: - number - 'null' description: >- Pool reactions it gets once live; null when the schedule could not be read. appUrl: type: string description: Opens the post in Enginy. required: - publishingPostId - identityId - identityName - name - text - scheduledAt - reactionsAmount - appUrl meta: type: object properties: page: type: number pageSize: type: number total: type: number required: - page - pageSize - total required: - data - meta '400': description: >- Invalid query: `from` / `to` not an ISO date or date-time (or a day that does not exist, such as `2026-02-30`), `to` before `from`, or `pageSize` over 50 '403': description: >- Social Selling is not enabled for this workspace. Ask your workspace admin to enable the feature. security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.