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

# Link a Discord channel to a creator

> Make a Discord text channel that you created the creator's space on this program's Discord server. Launchpoint then sends that creator's drafts and notices there.

Use this when your own flow creates each creator's channel and creator channel creation is turned off in the program's Discord settings. It replaces the creator's earlier space for this program; it does not delete that space.

The channel must be a text or announcement channel in the program's server, and the Launchpoint bot must be able to see it and post in it. A thread is not accepted. This route does not give the creator access to the channel.



## OpenAPI

````yaml /api-reference/openapi.json put /programs/{id}/creators/{creatorId}/discord-channel
openapi: 3.0.4
info:
  title: Launchpoint Public API
  version: 1.0.0
  description: >-
    **Private preview.** The Launchpoint Public API is in private preview and
    available only to trusted partners we work with directly. Access is not
    self-serve. Email hi@launchpointhq.com to ask about access.


    REST API for Launchpoint brands and agencies. Use an API key in the
    `x-api-key` header to authenticate.


    ## Requirements

    - Public API access must be enabled for the company. During private preview,
    access is limited to trusted partners.

    - Create and manage API keys in Dashboard → Settings → Developer.


    ## Creator privacy

    - Responses never include creator email addresses. Creator phone numbers are
    null when no number is stored or the workspace does not have access to
    creator contact details.


    ## Rate limits

    - Default: **100 requests per minute** per API key.

    - Approved partner accounts: **400 requests per minute**.

    - Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and
    `X-RateLimit-Reset`. Requests over the limit return `429`.


    ## Errors

    - Errors use `{ "error": "<message>" }` with the matching HTTP status. Some
    endpoints also include a `code`.


    ## Timestamps

    - Timestamps are Unix timestamps in milliseconds unless a field says
    otherwise.


    ## Pagination

    - Most list endpoints accept `page` and `limit` and return `{ data, page,
    total }`. Some also return `totalPages`.

    - `scope=company` is the default. A parent agency key can pass
    `scope=agency` on supported routes to include its own data and linked
    brands.
servers:
  - url: https://dashboard.launchpointhq.com/api/v1
    description: Live API server
security:
  - apiKeyAuth: []
tags:
  - name: Deals
    description: Public creator opportunities across Launchpoint
  - name: Programs
    description: Programs and campaign management
  - name: Posts
    description: Posts and social content
  - name: Analytics
    description: KPIs and performance metrics
  - name: Payouts
    description: Payouts, balances, and pending creator funds
  - name: Contracts
    description: Contracts and creator agreements
  - name: Creators
    description: Creator profiles and metrics
  - name: Applications
    description: Creator applications to Canvas programs
  - name: Messages
    description: Read and send creator messages
  - name: Onboarding
    description: 'Creator onboarding: status, messages, and proof review'
  - name: Media review
    description: >-
      Review the media creators send before they post: queue, status, approve,
      and reject
paths:
  /programs/{id}/creators/{creatorId}/discord-channel:
    put:
      tags:
        - Creators
      summary: Link a Discord channel to a creator
      description: >-
        Make a Discord text channel that you created the creator's space on this
        program's Discord server. Launchpoint then sends that creator's drafts
        and notices there.


        Use this when your own flow creates each creator's channel and creator
        channel creation is turned off in the program's Discord settings. It
        replaces the creator's earlier space for this program; it does not
        delete that space.


        The channel must be a text or announcement channel in the program's
        server, and the Launchpoint bot must be able to see it and post in it. A
        thread is not accepted. This route does not give the creator access to
        the channel.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
          description: The program id
        - in: path
          name: creatorId
          required: true
          schema:
            type: string
          description: The creator `id` from `GET /creators`
        - $ref: '#/components/parameters/ScopeParam'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - channelId
              properties:
                channelId:
                  type: string
                  description: The Discord text channel id
                  example: '1200000000000000002'
      responses:
        '200':
          description: Channel linked
          content:
            application/json:
              schema:
                type: object
                properties:
                  programId:
                    type: string
                    format: uuid
                  creatorId:
                    type: string
                  channelId:
                    type: string
                  channelName:
                    type: string
                    nullable: true
        '400':
          description: Invalid request, creator id, or channel id
        '401':
          description: Unauthorized - API key is invalid
        '403':
          description: The program is read-only for this API key
        '404':
          description: >-
            Program not found, the creator is not an approved creator in this
            program, or the channel was not found as a text or announcement
            channel in the program's server
        '409':
          description: >-
            The program has no connected Discord server, the channel is linked
            to another creator, or the Launchpoint bot cannot post in the
            channel
        '429':
          description: Request rate limit exceeded
components:
  parameters:
    ScopeParam:
      in: query
      name: scope
      required: false
      schema:
        type: string
        enum:
          - company
          - agency
        default: company
      description: >-
        Choose the data scope. `company` (default) limits results to the API key
        company's data. `agency` includes the parent agency and its linked
        brands. `scope=agency` requires a parent agency key; other keys receive
        `403`.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created in Dashboard → Settings → Developer

````

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