> ## 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.

# Schedule a Social Selling post

> Schedule a plain-text LinkedIn post: Enginy publishes it at `scheduledAt` from the LinkedIn account of `identityId` (an identity the caller may use), optionally followed by `reactionsAmount` reactions from the workspace’s identity pool. The identity’s owner receives a confirmation email. Text only: no images, documents, mentions, company page or scheduled comments (edit the post in Enginy for those, via `appUrl`). Answers `publishingPostId`, which `cancel_a_scheduled_social_selling_post` takes until the publish time. Not idempotent: a retry schedules a second post.

    > **Required scope:** `SOCIAL_SELLING_WRITE`
    >
    > **Rate limit:** 10 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json post /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:
    post:
      tags:
        - Social Selling
      summary: Schedule a Social Selling post
      description: >-
        Schedule a plain-text LinkedIn post: Enginy publishes it at
        `scheduledAt` from the LinkedIn account of `identityId` (an identity the
        caller may use), optionally followed by `reactionsAmount` reactions from
        the workspace’s identity pool. The identity’s owner receives a
        confirmation email. Text only: no images, documents, mentions, company
        page or scheduled comments (edit the post in Enginy for those, via
        `appUrl`). Answers `publishingPostId`, which
        `cancel_a_scheduled_social_selling_post` takes until the publish time.
        Not idempotent: a retry schedules a second post.

            > **Required scope:** `SOCIAL_SELLING_WRITE`
            >
            > **Rate limit:** 10 requests per minute
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                identityId:
                  type: integer
                  exclusiveMinimum: 0
                  description: >-
                    The connected LinkedIn identity that publishes the post (an
                    id of `get_identities`). It must be an identity the caller
                    may use.
                  example: 12
                text:
                  type: string
                  minLength: 1
                  maxLength: 3000
                  description: >-
                    The post text, 1–3000 characters, published as is (plain
                    text: no mentions, media or formatting).
                scheduledAt:
                  type: string
                  format: date-time
                  description: >-
                    When to publish, as an ISO 8601 date-time with offset: at
                    least 2 minutes and at most 365 days from now.
                  example: '2026-11-03T09:30:00Z'
                name:
                  type: string
                  minLength: 1
                  maxLength: 200
                  description: >-
                    Display name in Enginy. Defaults to the first line of the
                    text (40 characters).
                reactionsAmount:
                  type: integer
                  minimum: 0
                  maximum: 500
                  description: >-
                    Reactions from the workspace’s identity pool once the post
                    is live (0–500). Default 0.
                reactionTypes:
                  type: array
                  items:
                    type: string
                    enum:
                      - LIKE
                      - PRAISE
                      - EMPATHY
                      - INTEREST
                      - APPRECIATION
                      - ENTERTAINMENT
                  minItems: 1
                  description: >-
                    Reaction kinds for `reactionsAmount`. Defaults to the
                    LinkedIn mix.
              required:
                - identityId
                - text
                - scheduledAt
      responses:
        '201':
          description: Post scheduled
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      publishingPostId:
                        type: number
                        description: >-
                          The scheduled post. Pass it to
                          `cancel_a_scheduled_social_selling_post` to cancel it.
                        example: 29371
                      identityId:
                        type: number
                      scheduledAt:
                        type: string
                        description: ISO timestamp it will be published at.
                      name:
                        type:
                          - string
                          - 'null'
                      appUrl:
                        type: string
                        description: >-
                          Opens the post in Enginy (edit, cancel, add
                          engagement).
                    required:
                      - publishingPostId
                      - identityId
                      - scheduledAt
                      - name
                      - appUrl
                required:
                  - status
                  - message
                  - data
        '400':
          description: >-
            Invalid body: empty or too long text, `scheduledAt` not an ISO
            date-time or outside 2 minutes to 365 days from now,
            `reactionsAmount` out of range, unknown reaction type
        '403':
          description: >-
            Social Selling is not enabled for this workspace. Ask your workspace
            admin to enable the feature.
        '404':
          description: >-
            Identity not found in this workspace, or outside the caller’s
            identity scope
        '503':
          description: >-
            The post could not be scheduled right now. It is normally rolled
            back; check `list_scheduled_social_selling_posts` before retrying so
            it is not scheduled twice
      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.