oauth-connect

Start OAuth authorization for an integration

Returns an authorize URL. The frontend opens it in a popup; the user approves on the vendor's site; the vendor redirects back to /callback which stores the connection and messages the opener window.

post/v1/oauth/{vendor_id}/authorize

Request

  • Base URL: https://api.slideforge.dev
  • URL: https://api.slideforge.dev/v1/oauth/{vendor_id}/authorize
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

vendor_idstring required

Request body

integration_idstring required

Integration being connected (e.g. 'zoho_sprints')

regionstring nullable

Provider region (e.g. 'in', 'com', 'eu')

display_namestring nullable

User-chosen label for this connection

return_tostring nullable

Frontend URL to redirect to after success

extra_scopesstring[] nullable

Additional scopes to request (for scope-upgrade flows)

Response

Successful Response

unknown required

Changes

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