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

# Start OAuth connection

> Returns the provider authorization URL to redirect the merchant to. The merchant approves scopes on the provider page — Vambe never collects credentials.

Returns the provider authorization URL to redirect the merchant to. The merchant
approves the requested scopes on the provider's own page — Vambe never collects
provider credentials. After approval the provider redirects back to Vambe's
callback, which exchanges the code and persists the installation.


## OpenAPI

````yaml post /api/ecommerce-app/{id}/connect
openapi: 3.0.0
info:
  title: Vambe AI API
  description: Vambe AI documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://api.vambe.me
    description: Production Server
security: []
tags:
  - name: Vambe AI
    description: ''
paths:
  /api/ecommerce-app/{id}/connect:
    post:
      tags:
        - Custom Ecommerce Apps · Management
      summary: Start OAuth connection
      description: >-
        Returns the provider authorization URL to redirect the merchant to. The
        merchant approves scopes on the provider page — Vambe never collects
        credentials.
      operationId: EcommerceAppController_connect
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      responses:
        '201':
          description: ''

````