GEgetsales
provider_connections

Start provider OAuth connect

Leg 1 of connecting HubSpot: mint the consent URL to open in a browser and a signed state (15 minutes, single-use). Nothing is written: a connection exists only once a grant does. The browser lands in the app, which relays the code and the state to complete_provider_connection_oauth. 422 oauth_app_not_configured on a plane without the HubSpot app.

Contract:

  • MCP tool start_provider_connection_oauth, registry package mcp.integrations/provider_connections, mount integrations.providers.
  • Operation action, response envelope action.
  • Flags: none.
post/api/provider-connections/oauth/authorize

Request

  • Base URL
    https://beta.getsales.io/integrations/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

provider'hubspot' required

hubspot.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

itemunknown required

Changes

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