AXL API

openapi: 3.1.0
info:
  title: AXL API
  version: '2026-11-02'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-02: 8 operation(s) read from 16 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; AXL has published no machine-readable contract that the pipeline
    could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 3
    documentation: 5
    pages-with-code: 16
    pages-read: 16
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-02'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://axl.tech/developers/api
  - https://docs.axl.tech/calling-the-scenario-via-the-api
  - https://axl.tech/vs/vapi
  - https://axl.tech/vs/skool
  - https://axl.tech/developers
  - https://axl.tech/vs/clickfunnels
  - https://axl.tech/developers/webhooks
  - https://axl.tech/developers/mcp/cline
  - https://axl.tech/developers/mcp/claude
  - https://axl.tech/alternatives/clickfunnels
  - https://axl.tech/developers/mcp
  - https://axl.tech/developers/mcp/cursor
  - https://axl.tech/developers/mcp/chatgpt
  - https://axl.tech/developers/mcp/vs-code
  - https://axl.tech/developers/mcp/windsurf
  - https://axl.tech/developers/agent-guardrails
servers:
- url: https://app.axl.tech
paths:
  /api/v1/crm/lead:
    get:
      operationId: get_api_v1_crm_lead
      tags:
      - Api
      summary: Read fifty contacts in one request.
      description: Contacts live under crm/lead; the count rides back on the echoed filter.
      x-source: https://axl.tech/developers/api
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated list of fields to include, e.g. {id,firstName,email,tags{id,text}}
      - name: take
        in: query
        required: false
        schema:
          type: integer
        description: Number of records to return
      - name: skip
        in: query
        required: false
        schema:
          type: integer
        description: Number of records to skip
      - name: useItemsTotal
        in: query
        required: false
        schema:
          type: boolean
        description: Whether to include total count in the filter
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CrmLeadResponse'
      x-evidence:
        kind: documentation
  /api/v1/scenario/run:
    get:
      operationId: get_api_v1_scenario_run
      tags:
      - Api
      summary: GET /api/v1/scenario/run
      x-source: https://docs.axl.tech/calling-the-scenario-via-the-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -G \"https://app.axl.tech/api/v1/scenario/run\"  -H \"Authorization: Bearer YOUR_API_KEY\"  --data-urlencode \"scenarioId=YOUR_AUTOMATION_ID\"\
          \  --data-urlencode \"contactData.email=olivia.bennett@example.com\"  --data-urlencode \"contactData.firstName=Olivia\"  --data-urlencode\
          \ \"contactData.phone=+12025550184\" \n When the tool can only open a URL: \n https://app.axl.tech/api/v1/scenario/run?admin_access_"
    post:
      operationId: post_api_v1_scenario_run
      tags:
      - Api
      summary: POST /api/v1/scenario/run
      x-source: https://docs.axl.tech/calling-the-scenario-via-the-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ScenarioRunRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST \"https://app.axl.tech/api/v1/scenario/run\"  -H \"Authorization: Bearer YOUR_API_KEY\"  -H \"Content-Type: application/json\"\
          \  -d '{\n \"scenarioId\": \"YOUR_AUTOMATION_ID\",\n \"contactData\": {\n \"email\": \"olivia.bennett@example.com\",\n \"firstName\"\
          : \"Olivia\",\n \"lastName\": \"Bennett\",\n \"phone\": \"+12025550184\",\n \"tags\": [\"webinar-lead\"],\n \"enrollment_source\": \"\
          Fall webinar\"\n },\n \"data\": {\n \"order\": {"
  /leads:
    post:
      operationId: post_leads
      tags:
      - Leads
      summary: Post a lead to your own system, then branch on the answer
      description: Outbound webhook example that posts lead data to your endpoint. The response status code is used for branching.
      x-source: https://axl.tech/developers/webhooks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostLeadsRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /mcp:
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: GET /mcp
      x-source: https://axl.tech/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: httpie
        snippet: 'http https://app.axl.tech/mcp '
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: Connect VS Code to AXL via MCP server
      description: The MCP server speaks JSON‑RPC over POST only; use this endpoint to send JSON‑RPC requests from VS Code.
      x-source: https://axl.tech/developers/mcp/vs-code
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/register:
    post:
      operationId: post_oauth_register
      tags:
      - Oauth
      summary: Register a public OAuth client (RFC 7591)
      description: Registers a public client with no secret as part of the OAuth 2.1 flow.
      x-source: https://axl.tech/developers/mcp
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/token:
    post:
      operationId: post_oauth_token
      tags:
      - Oauth
      summary: Exchange authorization code for token using PKCE
      description: Exchanges a single-use authorization code for an access token, requiring a PKCE verifier.
      x-source: https://axl.tech/developers/mcp
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1CrmLeadResponse:
      type: object
      properties:
        items:
          type: array
          description: Array of lead objects
        filter:
          type: object
          description: Metadata about the result set, includes itemsTotal
        filter.itemsTotal:
          type: integer
          description: Total number of items matching the query
    PostApiV1ScenarioRunRequest:
      type: object
      properties:
        scenarioId:
          type: string
        contactData:
          type: object
          properties:
            email:
              type: string
            firstName:
              type: string
            lastName:
              type: string
            phone:
              type: string
            tags:
              type: array
              items:
                type: string
            enrollment_source:
              type: string
        data:
          type: object
          properties:
            order:
              type: object
              properties:
                amount:
                  type: integer
    PostLeadsRequest:
      type: object
      properties:
        email:
          type: string
          description: Lead email address
        name:
          type: string
          description: Lead name
        source:
          type: string
          description: Source identifier, e.g., "axl"
      required:
      - email
      - name
      - source
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Leads
- name: Mcp
- name: Oauth