KHkhotan
Integrations

Mint an access token (secret)

Mints a fresh, short-lived OAuth access token for a Gmail or Outlook integration using its stored refresh token, and returns it with its expiry and scopes. The token grants access to the connected mailbox; treat it as a secret. Returns 409 connection_unusable if the grant was revoked at the provider, and 503 provider_not_configured if the integration's provider is not configured in this environment.

post/api/v1/integrations/{integrationId}/token

Request

  • Base URL
    https://app.khotan.com
  • URL
    https://app.khotan.com/api/v1/integrations/{integrationId}/token
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Path parameters

integrationIdstring required

Response

A freshly-minted access token. Secret-bearing.

accessTokenstring required
tokenType'Bearer' required
expiresAtstring nullable required
scopesstring[] required

Changes

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