OAuth

OAuth Authorization Endpoint

Initiate OAuth authorization flow and get consent screen information

get/oauth/authorize

Request

  • Base URL
    https://api.midday.ai
  • URL
    https://api.midday.ai/oauth/authorize
  • Auth
    • OAuth 2
      Authorization code: https://app.midday.ai/oauth/authorize
      Token URL: https://api.midday.ai/oauth/token
    • or HTTP bearer

Query parameters

response_type'code' required

OAuth response type, must be 'code'

Example:code
client_idstring required

Client ID of the OAuth application

Example:mid_client_abcdef123456789
redirect_uristring uri required

Redirect URI for OAuth callback

Example:https://myapp.com/callback
scopestring required

Space-separated list of requested scopes

Example:transactions.read invoices.read
statestring required

Opaque state parameter for CSRF protection

Example:abc123xyz789_secure-random-state-value
code_challengestring

Code challenge for PKCE (S256)

Example:E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
code_challenge_method'S256'

Code challenge method, must be S256

Example:S256
resourcestring uri

Resource parameter per RFC 9728 — identifies the MCP server

Example:https://api.midday.ai

Response

Application information for consent screen

idstring uuid required

Application ID

namestring required

Application name

descriptionstring nullable required

Application description

overviewstring nullable required

Application overview

developerNamestring nullable required

The person or company developing this application

logoUrlstring nullable required

Application logo URL

websitestring nullable required

Application website

installUrlstring nullable required

An optional URL for installing the application

screenshotsstring[] required

Up to 4 screenshots that will be displayed on the apps page

clientIdstring required

Client ID

scopesstring[] required

Requested scopes

redirectUristring uri required

Redirect URI

statestring

Opaque state parameter

status'draft' | 'pending' | 'approved' | 'rejected' required

Application verification status

Example response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "My Raycast Extension",
  "description": "A Raycast extension for managing transactions",
  "overview": "This application provides advanced transaction management features including:\n- Real-time sync\n- Advanced filtering",
  "developerName": "Acme Corp",
  "logoUrl": "https://example.com/logo.png",
  "website": "https://myapp.com",
  "installUrl": "https://myapp.com/install",
  "screenshots": [
    "https://example.com/screenshot1.png",
    "https://example.com/screenshot2.png"
  ],
  "clientId": "mid_client_abcdef123456789",
  "scopes": [
    "transactions.read",
    "invoices.read"
  ],
  "redirectUri": "https://myapp.com/callback",
  "state": "abc123xyz789_secure-random-state-value",
  "status": "approved"
}

Changes

No recorded changes to this operation across all 1 revision of this API.