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

# Start the OAuth authorization-code flow (PKCE S256)

> Redirect the user here. On approval the browser is redirected to redirect_uri with a code and state.



## OpenAPI

````yaml /api-reference/openapi.json get /oauth/authorize
openapi: 3.1.0
info:
  title: Meradomo Public API
  version: 1.0.0
  description: >-
    Two surfaces: the local management API on 127.0.0.1:8765 (Publish) and the
    OAuth endpoints on account.meradomo.com (Connect). No SDK — these HTTP
    endpoints are the integration surface.
  license:
    name: MIT
servers:
  - url: http://127.0.0.1:8765
    description: Local management API (Publish)
  - url: https://account.meradomo.com
    description: Control plane (Connect / OAuth)
security: []
paths:
  /oauth/authorize:
    get:
      tags:
        - Connect (OAuth)
      summary: Start the OAuth authorization-code flow (PKCE S256)
      description: >-
        Redirect the user here. On approval the browser is redirected to
        redirect_uri with a code and state.
      operationId: authorize
      parameters:
        - name: client_id
          in: query
          required: true
          schema:
            type: string
        - name: redirect_uri
          in: query
          required: true
          schema:
            type: string
          description: Must exactly match a registered URI.
        - name: response_type
          in: query
          required: true
          schema:
            type: string
            enum:
              - code
        - name: state
          in: query
          required: true
          schema:
            type: string
        - name: code_challenge
          in: query
          required: true
          schema:
            type: string
        - name: code_challenge_method
          in: query
          required: true
          schema:
            type: string
            enum:
              - S256
        - name: scope
          in: query
          required: true
          schema:
            type: string
            enum:
              - connect
      responses:
        '302':
          description: Redirect to redirect_uri?code=…&state=… (or ?error=access_denied)
      servers:
        - url: https://account.meradomo.com

````