Sign in
Connectors

Connect HubSpot

Connect on HubSpot posts the private app token from the token field. The server checks that token, stores it sealed, and answers only that the connection is on.

post/v1/connections/{name}/api-key

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/connections/{name}/api-key
  • Auth: HTTP bearer

Path parameters

namestring required

Connector name.

Example:hubspot

HubSpot connector name.

Request body

apiKeystring required

Vendor API key. Stored sealed at rest and never returned by connector list endpoints.

Example request

{
  "apiKey": "example-vendor-key"
}

Response

HubSpot is connected.

audiencestring

Audience accepted by the product resource server.

connectedboolean required

Whether the connector is now connected.

connectionIdstring

Stable connection UUID used in product-side revocation checks.

connectorstring

Connector slug.

scopesstring[]

Scopes granted by the completed consent flow.

Example response

{
  "audience": "mcp:canvas",
  "connected": true,
  "connectionId": "123e4567-e89b-12d3-a456-426614174000",
  "connector": "canvas",
  "scopes": [
    "canvas:invoices.read"
  ]
}

Changes

No recorded changes to this operation across all 50 revisions of this API.