> ## Documentation Index
> Fetch the complete documentation index at: https://help.opus.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Social Copy Generation Job

> You can start a social copy generation job by making a `POST` request to `https://api.opus.pro/api/social-copy-jobs`.



## OpenAPI

````yaml POST /api/social-copy-jobs
openapi: 3.0.0
info:
  title: Clip API
  description: Clip API documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://api.opus.pro
    description: OpusClip Open API Production Server
security: []
tags: []
paths:
  /api/social-copy-jobs:
    post:
      tags:
        - social-posting
        - enterprise
      description: >-
        Create an asynchronous social copy generation job for a specific clip
        and destination account.
      operationId: SocialCopyJobController_createSocialCopyJob
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            example:
              projectId: P0000000demo
              clipId: CUexample1
              postAccountId: postAccountId_xxx1
              subAccountId: subAccountId_xxx1
              prompt: >-
                Write the caption in a playful, witty tone that uses humor to
                keep the audience engaged, while ending with a clear call to
                action.
              forceRegenerate: false
            schema:
              type: object
              required:
                - projectId
                - clipId
                - postAccountId
                - subAccountId
              properties:
                projectId:
                  type: string
                  description: Project ID
                clipId:
                  type: string
                  description: >-
                    Bare clip ID (e.g. `CUexample1`). **Not** the composite
                    `{projectId}.{clipId}` form returned as `id` by `GET
                    /api/exportable-clips` — pass only the part after the dot.
                postAccountId:
                  type: string
                  description: Unique ID of the connected social account record
                subAccountId:
                  type: string
                  description: >-
                    Sub-account ID used by Facebook pages, Instagram business
                    accounts, or LinkedIn
                prompt:
                  type: string
                  description: Custom style or tone instruction for generation
                forceRegenerate:
                  type: boolean
                  description: Whether to bypass the cached result and regenerate
      responses:
        '201':
          description: Successfully created a social copy generation job
          content:
            application/json:
              example:
                data:
                  jobId: 96e3d68c-49ef-4c19-b3b6-595f9564537c
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - jobId
                    properties:
                      jobId:
                        type: string
                        description: Unique ID of the social copy generation job
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````