Block · OAuth Scopes

Block OAuth Scopes

OAuth 2.0 derived

Block publishes 6 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Block API on a user’s behalf.

Tokens are issued from https://connect.squareup.com/oauth2/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

CommerceCryptocurrencyeCommerceFintechPaymentsPoint Of SaleSquare
Scopes: 6 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://connect.squareup.com/oauth2/authorize
Token URL
https://connect.squareup.com/oauth2/token
Flows
authorizationCode

Scopes (6)

ScopeDescriptionFlows
CUSTOMERS_READ Read customers authorizationCode
CUSTOMERS_WRITE Write customers authorizationCode
ORDERS_READ Read orders authorizationCode
ORDERS_WRITE Write orders authorizationCode
PAYMENTS_READ Read payments authorizationCode
PAYMENTS_WRITE Write payments authorizationCode

Source

OAuth Scopes

block-scopes.yml Raw ↑
generated: '2026-07-11'
method: derived
source: openapi/block-square-api-openapi.yaml
schemes:
- name: OAuth2
  source: openapi/block-square-api-openapi.yaml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://connect.squareup.com/oauth2/authorize
    tokenUrl: https://connect.squareup.com/oauth2/token
scopes:
- scope: CUSTOMERS_READ
  description: Read customers
  flows:
  - authorizationCode
  sources:
  - openapi/block-square-api-openapi.yaml
- scope: CUSTOMERS_WRITE
  description: Write customers
  flows:
  - authorizationCode
  sources:
  - openapi/block-square-api-openapi.yaml
- scope: ORDERS_READ
  description: Read orders
  flows:
  - authorizationCode
  sources:
  - openapi/block-square-api-openapi.yaml
- scope: ORDERS_WRITE
  description: Write orders
  flows:
  - authorizationCode
  sources:
  - openapi/block-square-api-openapi.yaml
- scope: PAYMENTS_READ
  description: Read payments
  flows:
  - authorizationCode
  sources:
  - openapi/block-square-api-openapi.yaml
- scope: PAYMENTS_WRITE
  description: Write payments
  flows:
  - authorizationCode
  sources:
  - openapi/block-square-api-openapi.yaml