Accounts & connections · Connect

Get HubSpot OAuth connect URL

Fetches a HubSpot OAuth connect URL.

GEThttps://api.pozy.ai/v1/connect/hubspot
Needs a connect tokengetHubSpotConnectUrl

Guides: Hosted connect pages, HubSpot

Request

Call it from your server with your API key and pass the short-lived token from the connect flow in the X-Connect-Token header. See Headless connect.

Query parameters

NameTypeNotes
profileIdrequiredstring
redirect_urlstring

Example

curl -X GET "https://api.pozy.ai/v1/connect/hubspot?profileId=6a0b6573846efc28aaa9a3ff" \
  -H "X-Connect-Token: $CONNECT_TOKEN"

Response

200 on success

  • authUrlstring (URL)required
  • statestringrequired
200 response
{
  "authUrl": "https://pozy.ai/media/example-1.jpg",
  "state": "string"
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400invalid_request_errorA parameter or body field is missing or invalid. param names it.
401authentication_errorThe API key is missing, revoked or expired.
403permission_errorThe key is scoped to other profiles or has this resource group disabled.
429rate_limit_errorToo many requests this minute. Wait for Retry-After seconds.

Every code is listed in Errors.

More in Connect

GETGet OAuth connect URLPOSTComplete OAuth callbackGETConnect ads for a platformGETGet Shopify OAuth connect URLPOSTConnect a Shopify store with a custom-app Admin tokenGETGet Google Analytics OAuth connect URLGETList Google Analytics properties for a pending connectPOSTConnect the chosen Google Analytics propertyGETGet WordPress.com OAuth connect URLGETGet Wix site install URLGETGet Webflow OAuth URLPOSTConnect Webflow with a site API tokenPOSTConnect self-hosted WordPress with an application passwordPATCHSet TikTok brand identityGETList Facebook pagesPOSTSelect Facebook pageGETList Pages with a linked Instagram accountPOSTSelect the Page whose Instagram account to connectGETList Google Business Profile locationsPOSTSelect Google Business Profile locationGETGet a phone handoffGETGet the saved welcome screenPUTSave the welcome screenGETList your OAuth appsPOSTAdd an OAuth appGETGet an OAuth appPATCHUpdate an OAuth appDELRemove an OAuth appPOSTCheck an OAuth app's keysGETGet pending OAuth dataGETList LinkedIn orgsPOSTSelect LinkedIn orgGETList Pinterest boardsPOSTSelect Pinterest boardGETList Snapchat profilesPOSTSelect Snapchat profilePOSTConnect Bluesky accountPOSTConnect an OpenAI Ads accountPOSTConnect a Whop accountPOSTConnect WhatsApp via credentialsGETList numbers for selectionPOSTComplete number selectionPOSTConnect WhatsApp from Embedded SignupGETGet Embedded Signup SDK configPOSTConnect a Discord channelGETList Slack channels for the channel pickerPOSTConnect a Slack channelGETGenerate Telegram codePOSTConnect Telegram directlyPATCHCheck Telegram statusGETRead a Facebook Page's webhook subscriptionPOSTRe-subscribe a Facebook Page to Pozy's webhooksGETList Facebook pagesPUTUpdate Facebook pageGETList LinkedIn orgsPUTSwitch LinkedIn account typeGETList Pinterest boardsPOSTCreate Pinterest boardPUTSet default Pinterest boardGETGet a YouTube video transcriptGETList YouTube playlistsPOSTCreate YouTube playlistPUTSet default YouTube playlistGETList Google Business Profile locationsPUTUpdate Google Business Profile locationPOSTAssign Google Business Profile location to another profileGETList Reddit subredditsPUTSet default subredditGETGet subreddit rulesPOSTVote on a Reddit post or commentGETList subreddit flairsPOSTSet Reddit post flairGETAdmin-consent link for a Microsoft tenant