Accounts & connections · Accounts
Fetches HubSpot account settings.
Request
Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the accounts resource group disabled get 403 resource_group_disabled. Authentication
Path parameters
| Name | Type | Notes |
|---|---|---|
accountIdrequired | string |
Example
curl -X GET "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/hubspot-settings" \
-H "Authorization: Bearer $POZY_API_KEY"const res = await fetch("https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/hubspot-settings", {
headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);import os
import requests
resp = requests.get(
"https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/hubspot-settings",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
accountobject8 child fields
_idstringrequiredplatformstringrequiredOne of
hubspot.hubIdstringrequiredhubDomainstringrequiredCan be null.
scopesarray of stringrequiredsyncContactsbooleanrequiredlogMessagesbooleanrequiredreportDealsbooleanrequired
200 response
{
"account": {
"_id": "635d87e261ae344ef27fd1df",
"platform": "hubspot",
"hubId": "6aa008996e22fdf9f74c382e",
"hubDomain": "string",
"scopes": [
"string"
],
"syncContacts": true,
"logMessages": true,
"reportDeals": true
}
}Errors
Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:
| 400 | invalid_request_error | A parameter or body field is missing or invalid. param names it. |
| 401 | authentication_error | The API key is missing, revoked or expired. |
| 403 | permission_error | The key is scoped to other profiles or has this resource group disabled. |
| 404 | not_found | Nothing with that id exists in your workspace. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.
More in Accounts
GETList accountsGETGet follower statsPUTUpdate accountPATCHMove account to another profileDELDisconnect accountGETCheck accounts healthGETCheck account healthGETList posts published on the platformGETCheck whether an Instagram user follows the accountGETList trending commercial musicGETSearch TikTok location tagsGETGet TikTok creator infoGETList partner businesses of the PagePOSTShare the Page with a partner businessDELRevoke a partner business from the PagePATCHUpdate HubSpot account settingsGETGet Slack account settingsPATCHUpdate Slack account settingsGETGet Bluesky account settingsPATCHUpdate Bluesky account settings