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

# Prepare a launch on the AdStellar Launch page for a person to review, edit and launch there. Puts images and videos from Assets (sizes of the same creative become one ad), optionally existing Meta ad sets of the ad account and shared copy, into a new launch and returns its URL plus what is still missing before it can launch. Does NOT launch anything: nothing is written to Meta and nothing is spent, and the ads start paused. It cannot create campaigns or ad sets (use build_campaign to build a new campaign). Requires an active subscription and the Launch page enabled for the team.

> Prepare a launch on the AdStellar Launch page for a person to review, edit and launch there. Puts images and videos from Assets (sizes of the same creative become one ad), optionally existing Meta ad sets of the ad account and shared copy, into a new launch and returns its URL plus what is still missing before it can launch. Does NOT launch anything: nothing is written to Meta and nothing is spent, and the ads start paused. It cannot create campaigns or ad sets (use build_campaign to build a new campaign). Requires an active subscription and the Launch page enabled for the team.



## OpenAPI

````yaml /openapi.json post /tools/prepare_launch_page
openapi: 3.1.0
info:
  title: AdStellar API
  version: 1.0.0
  description: >-
    Public REST API for AdStellar — creative generation, video generation,
    campaign management, and analytics. Every endpoint maps 1:1 to an AdStellar
    MCP tool.
servers:
  - url: https://app.adstellar.ai/api/v1
security: []
paths:
  /tools/prepare_launch_page:
    post:
      summary: >-
        Prepare a launch on the AdStellar Launch page for a person to review,
        edit and launch there. Puts images and videos from Assets (sizes of the
        same creative become one ad), optionally existing Meta ad sets of the ad
        account and shared copy, into a new launch and returns its URL plus what
        is still missing before it can launch. Does NOT launch anything: nothing
        is written to Meta and nothing is spent, and the ads start paused. It
        cannot create campaigns or ad sets (use build_campaign to build a new
        campaign). Requires an active subscription and the Launch page enabled
        for the team.
      description: >-
        Prepare a launch on the AdStellar Launch page for a person to review,
        edit and launch there. Puts images and videos from Assets (sizes of the
        same creative become one ad), optionally existing Meta ad sets of the ad
        account and shared copy, into a new launch and returns its URL plus what
        is still missing before it can launch. Does NOT launch anything: nothing
        is written to Meta and nothing is spent, and the ads start paused. It
        cannot create campaigns or ad sets (use build_campaign to build a new
        campaign). Requires an active subscription and the Launch page enabled
        for the team.
      operationId: prepare_launch_page
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                adAccountId:
                  type: string
                  pattern: ^(act_)?\d{1,32}$
                  description: >-
                    Meta ad account id (from list_ad_accounts). Must be
                    connected to the workspace.
                name:
                  description: >-
                    A name for the launch, as the user would recognise it in
                    their list of launches.
                  type: string
                  minLength: 1
                  maxLength: 200
                assetIds:
                  minItems: 1
                  maxItems: 200
                  type: array
                  items:
                    type: string
                    pattern: >-
                      ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
                  description: >-
                    Media asset ids (uuids) of the images and videos to launch,
                    1 to 200. Sizes of the same creative become ONE ad (up to 3
                    sizes).
                adSetIds:
                  description: >-
                    Meta ids of EXISTING ad sets of this ad account that every
                    ad goes into (up to 20). All website ad sets or all instant
                    form ad sets, never a mix. Leave out to let the user choose
                    on the Launch page.
                  maxItems: 20
                  type: array
                  items:
                    type: string
                    pattern: ^\d{8,32}$
                primaryTexts:
                  description: >-
                    Primary text shared by every ad: the first is the main one,
                    the rest are variations (up to 5).
                  minItems: 1
                  maxItems: 5
                  type: array
                  items:
                    type: string
                    maxLength: 2000
                headlines:
                  description: >-
                    Headline shared by every ad: the first is the main one, the
                    rest are variations (up to 5).
                  minItems: 1
                  maxItems: 5
                  type: array
                  items:
                    type: string
                    maxLength: 255
                description:
                  description: Description shared by every ad.
                  type: string
                  maxLength: 255
                cta:
                  description: >-
                    Meta call to action type, e.g. SHOP_NOW, LEARN_MORE,
                    SIGN_UP.
                  type: string
                linkUrl:
                  description: >-
                    The web page the ads send people to (http or https). Not
                    used by instant form ads.
                  type: string
                  maxLength: 2048
                urlTags:
                  description: >-
                    URL parameters added to the link, e.g.
                    utm_source=meta&utm_campaign=spring (no leading "?").
                  type: string
                  maxLength: 2000
                displayLink:
                  description: The short link shown on the ad, e.g. example.com.
                  type: string
                  maxLength: 255
                pageId:
                  description: Facebook Page the ads run as.
                  type: string
                  pattern: ^\d{1,32}$
                instagramAccountId:
                  description: Instagram account the ads run as.
                  type: string
                  pattern: ^\d{1,32}$
                leadFormId:
                  description: >-
                    Meta instant form the ads open. Only when adSetIds are
                    instant form ad sets.
                  type: string
                  pattern: ^\d{1,32}$
                workspaceId:
                  description: >-
                    Workspace to act in (must be granted to this credential).
                    Omit for the primary workspace.
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
              required:
                - adAccountId
                - assetIds
              additionalProperties: false
      responses:
        '200':
          description: Tool result
        '401':
          description: Missing or invalid API key
        '403':
          description: Missing required scope
        '429':
          description: Rate limit exceeded
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AdStellar API key (ast_live_...)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.