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

# List connectors

> List supported services and their connection requirements.



## OpenAPI

````yaml /openapi.json get /connectors
openapi: 3.1.0
info:
  title: Motion
  version: 1.1.0
  description: >-
    Create Motion projects from prompts, read authored generations and outputs,
    and explicitly request renders or editor exports. Use reusable templates and
    brand kits. Credentials remain bound to current workspace access and
    permissions. Legacy single-video endpoints are deprecated.
servers:
  - url: https://api.motion.so/api/motion
security:
  - MotionApiKey: []
tags:
  - name: Projects
  - name: Project results
  - name: Project exports
  - name: Templates
  - name: Brand kits
  - name: Media library
  - name: Automations
  - name: Social posting
  - name: API information
  - name: Deprecated endpoints
    description: >-
      Older single-video routes remain callable for existing clients. Use the
      project API for new integrations; no removal date is scheduled.
  - name: Connectors
    description: Connect services and control the actions a project may use.
paths:
  /connectors:
    get:
      tags:
        - Connectors
      summary: List connectors
      description: List supported services and their connection requirements.
      operationId: ListConnectors
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MotionConnectorCatalog'
              example:
                connectors:
                  - id: github
                    name: GitHub
                    scope: organization
                    authentication: oauth
                    available: true
                    unavailable_reason: null
                    input_schema:
                      type: object
                      properties:
                        connector_id:
                          const: github
                      required:
                        - connector_id
                      additionalProperties: false
                    permission_options:
                      - id: repositories
                        label: Read repository details
                        write: false
                      - id: code
                        label: Read and search code
                        write: false
                      - id: issues
                        label: Read issues and pull requests
                        write: false
                      - id: history
                        label: Read commits and releases
                        write: false
                    project_usable: true
                    visibility: private
                  - id: youtube
                    name: YouTube
                    scope: organization
                    visibility: private
                    authentication: oauth
                    available: true
                    unavailable_reason: null
                    input_schema:
                      type: object
                      properties:
                        connector_id:
                          const: youtube
                        name:
                          type: string
                          minLength: 1
                          maxLength: 120
                        request_id:
                          type: string
                          format: uuid
                      required:
                        - connector_id
                      additionalProperties: false
                    permission_options:
                      - id: posts
                        label: Read accounts and posts
                        write: false
                      - id: prepare
                        label: Prepare posts for approval
                        write: true
                      - id: discard
                        label: Discard pending proposals
                        write: true
                    project_usable: true
        '400':
          description: Invalid provider inputs or credential verification failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Invalid or revoked credential.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Required scope or current account access denied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Private organization connection not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Provider setup is not configured or temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - MotionApiKey: []
        - MotionOAuth:
            - motion:connectors:read
components:
  schemas:
    MotionConnectorCatalog:
      type: object
      properties:
        connectors:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                enum:
                  - github
                  - notion
                  - google-drive
                  - getty
                  - s3
                  - tiktok
                  - youtube
                  - instagram
                  - facebook
                  - x
                  - threads
                  - linkedin
                  - reddit
                  - mastodon
                  - bluesky
                  - snapchat
              name:
                type: string
              scope:
                type: string
                const: organization
                description: >-
                  Connection belongs to the credential’s organization and
                  workspace.
              visibility:
                type: string
                const: private
              authentication:
                type: string
                enum:
                  - oauth
                  - credentials
                description: >-
                  OAuth requires a person to approve a link; credentials
                  requires the catalog input fields.
              available:
                type: boolean
              unavailable_reason:
                anyOf:
                  - type: string
                    enum:
                      - not_configured
                      - admin_required
                      - manager_required
                      - setup_unavailable
                      - account_access_required
                  - type: 'null'
                description: >-
                  Why setup is unavailable; null when this actor can start
                  connecting the service.
              input_schema:
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
                description: >-
                  JSON Schema for the exact Connect a service request accepted
                  by this catalog option.
              permission_options:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    label:
                      type: string
                    write:
                      type: boolean
                  required:
                    - id
                    - label
                    - write
                  additionalProperties: false
              project_usable:
                type: boolean
                description: Whether this connection can be selected in project prompts.
            required:
              - id
              - name
              - scope
              - visibility
              - authentication
              - available
              - unavailable_reason
              - input_schema
              - permission_options
              - project_usable
            additionalProperties: false
      required:
        - connectors
      additionalProperties: false
    ErrorResponse:
      type: object
      description: >-
        Error bodies are JSON. Check the HTTP status first. Permission and
        validation errors use error; service errors may use detail. Optional
        fields explain how to correct the request.
      anyOf:
        - required:
            - error
        - required:
            - detail
      properties:
        error:
          type: string
          description: Error code or readable explanation.
        detail:
          type: string
          description: Readable explanation from the service.
        message:
          type: string
          description: Readable explanation accompanying an error code.
        error_description:
          type: string
          description: Authentication or permission explanation.
        required_scope:
          type: string
          description: Permission required by this operation.
        details:
          type: array
          description: Invalid request fields. Each issue includes a path and message.
          items:
            type: object
            properties:
              code:
                type: string
              path:
                type: array
                items:
                  oneOf:
                    - type: string
                    - type: integer
              message:
                type: string
        issues:
          type: array
          description: Service validation issues.
          items:
            type: object
  securitySchemes:
    MotionApiKey:
      type: http
      scheme: bearer
      description: >-
        A Motion API key. Access is limited to its stored organization,
        workspace, scopes and the creator’s current permissions.
    MotionOAuth:
      type: oauth2
      description: >-
        OAuth REST tokens use the full MCP audience, https://mcp.motion.so/mcp.
        Reauthorize existing connections to add scopes. Current workspace roles
        and resource permissions still apply.
      flows:
        authorizationCode:
          authorizationUrl: https://mcp.motion.so/oauth/authorize
          tokenUrl: https://mcp.motion.so/oauth/token
          scopes:
            motion:automations:read: Read automation definitions, capabilities, runs, and analytics.
            motion:automations:write: Create, edit, delete, invoke, and retry automations.
            motion:connectors:read: >-
              Read available services, your private organization connections and
              allowed actions without secrets.
            motion:connectors:write: >-
              Connect and disconnect your private accounts inside the credential
              organization workspace.
            motion:templates:read: Read and preview accessible templates.
            motion:templates:write: Create, edit, share, and archive prompt templates.
            motion:sessions:read: Read permitted chats, job status and saved exports.
            motion:sessions:write: >-
              Create and steer Motion projects using organization workspace
              credits.
            motion:assets:read: Find and read permitted media library assets.
            motion:brand-kits:read: Read permitted brand kits.
            motion:brand-kits:write: Create and edit brand kits within current app permissions.
            motion:social:read: Read authorized social accounts and posts.
            motion:social:write: >-
              Draft, submit, approve and cancel posts within current app
              permissions.

````

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