ClickFunnels 2.0 API

openapi: 3.1.0
info:
  title: ClickFunnels 2.0 API
  description: |
    REST API for managing workspaces, funnels, pages, products, contacts,
    orders, subscriptions, and fulfillments in ClickFunnels 2.0.
    Account-level resources (teams, workspaces) are served from
    https://accounts.myclickfunnels.com. Workspace-scoped resources are served
    from a per-workspace subdomain (https://{workspace}.myclickfunnels.com).
    Authentication uses a Bearer access token; a User-Agent header is required.
  version: "2.0.0"
  contact:
    name: ClickFunnels Developers
    url: https://developers.myclickfunnels.com
servers:
  - url: https://accounts.myclickfunnels.com
    description: Account / team-level endpoints
  - url: https://{workspace}.myclickfunnels.com
    description: Workspace-scoped endpoints
    variables:
      workspace:
        default: myteam
        description: Workspace subdomain
security:
  - BearerAuth: []
paths:
  /api/v2/teams:
    get:
      summary: List teams
      description: List teams accessible to the authenticated API token.
      operationId: listTeams
      tags: [Teams]
      responses:
        '200':
          description: List of teams
  /api/v2/teams/{team_id}/workspaces:
    get:
      summary: List workspaces for a team
      operationId: listWorkspacesForTeam
      tags: [Workspaces]
      parameters:
        - in: path
          name: team_id
          required: true
          schema:
            type: string
      responses:
        '200':
          description: List of workspaces
  /api/v2/workspaces/{workspace_id}/contacts:
    get:
      summary: List contacts for a workspace
      operationId: listContacts
      tags: [Contacts]
      parameters:
        - in: path
          name: workspace_id
          required: true
          schema:
            type: string
      responses:
        '200':
          description: List of contacts
  /api/v2/workspaces/{workspace_id}/products:
    post:
      summary: Create a product
      description: Create a new product, including variant_properties (e.g., size/color).
      operationId: createProduct
      tags: [Products]
      parameters:
        - in: path
          name: workspace_id
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                variant_properties:
                  type: array
                  items:
                    type: object
      responses:
        '201':
          description: Product created
  /api/v2/products/{product_id}:
    patch:
      summary: Update a product
      operationId: updateProduct
      tags: [Products]
      parameters:
        - in: path
          name: product_id
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Product updated
  /api/v2/products/{product_id}/variants:
    post:
      summary: Create a product variant
      operationId: createProductVariant
      tags: [Products]
      parameters:
        - in: path
          name: product_id
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [properties_values, fulfillment_location_ids]
              properties:
                properties_values:
                  type: array
                  items:
                    type: object
                fulfillment_location_ids:
                  type: array
                  items:
                    type: string
      responses:
        '201':
          description: Variant created
  /api/v2/products/{product_id}/prices:
    post:
      summary: Create a price for a variant
      operationId: createPrice
      tags: [Products]
      parameters:
        - in: path
          name: product_id
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Price created
  /api/v2/fulfillments/locations:
    post:
      summary: Create a fulfillment location
      operationId: createFulfillmentLocation
      tags: [Fulfillments]
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Fulfillment location created
  /api/v2/fulfillments:
    post:
      summary: Create a fulfillment
      operationId: createFulfillment
      tags: [Fulfillments]
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Fulfillment created
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: ClickFunnels 2.0 API access token issued per team.