PUT/api/v1/hubspot/connection

Connect HubSpot

Saves the workspace's HubSpot service key (or a legacy private app's access token) in token, checked with HubSpot first: the account it's for and the scopes it has. A blank token checks the saved one again. Optional team_id: the team whose calls go to HubSpot. One HubSpot account connects to one workspace (409 otherwise); 400 when HubSpot doesn't accept the key. Admins and owners.

API token required20 per minute per IP

Guide: HubSpot

Code samples and Try it

Request body

#

application/json, required

  • workspace_idstringRequired

    Matches ^[0-9a-f]{24}$.

  • tokenstring

    A HubSpot service key or private app access token. Blank: keep the saved one. Up to 600 characters.

  • team_idstring

    Matches ^([0-9a-f]{24})?$.

Responses

#
  • 200OK.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?