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

# Create a Xero OAuth authorize URL

> Returns a Xero authorize URL and CSRF `state` bound to the caller workspace. Redirect the user to `authorize_url`; after Xero redirects back to the Range app with `code` and `state`, POST /account-connections with type=xero. When the consent covers more than one organisation, create responds with code `xero_tenant_required` and the call is retried with `xero.tenant_id`.



## OpenAPI

````yaml /api-reference/platform-api.json post /v2/account-connections/xero/authorize-url
openapi: 3.0.0
info:
  title: Range Platform API
  description: >-
    The Range Platform API for workspace management, counterparties, and
    operational tooling.
  version: 1.7.29
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
  - Authorization: []
tags:
  - name: Address Information
    description: Get information about a crypto address.
  - name: Transfer Enrichments
    description: Attach workspace-scoped notes and categories to transfers.
  - name: Counterparties
    description: Manage external entities, their addresses, bank accounts, and documents.
  - name: Parties
    description: >-
      The workspace entity register: the firm itself, its clients, and its
      counterparties.
paths:
  /v2/account-connections/xero/authorize-url:
    post:
      tags:
        - Account Connections
      summary: Create a Xero OAuth authorize URL
      description: >-
        Returns a Xero authorize URL and CSRF `state` bound to the caller
        workspace. Redirect the user to `authorize_url`; after Xero redirects
        back to the Range app with `code` and `state`, POST /account-connections
        with type=xero. When the consent covers more than one organisation,
        create responds with code `xero_tenant_required` and the call is retried
        with `xero.tenant_id`.
      operationId: createXeroAuthorizeUrl
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  authorize_url:
                    type: string
                  state:
                    type: string
components:
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Authorization method required to allow user to access the api endpoints.

````

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