---
title: "Get HubSpot integration status"
method: GET
path: "/api/user/{id}/integration/hubspot"
tags: ["User Management"]
---

# Get HubSpot integration status

`GET /api/user/{id}/integration/hubspot`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/user/{id}/integration/hubspot`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/user/:id/integration/hubspot/get.ts> (a function with typed inputs; its response is checked against the schema)

Answers whether the signed-in user's organization has HubSpot connected, so the Integrations page can show the connection to every user, and whether HubSpot export is available to the user, so the export menu can show or hide the option. The id must be the signed-in user's own. Every value is read from the stored organization connection - no request is made to HubSpot, and neither the access token nor the refresh token is returned. Unlike the organization endpoint this is not restricted to account administrators.

## Path parameters

- `id` integer, required

## Response `200`

HubSpot integration status

- UserHubspotIntegrationResource: Whether the user's organization has HubSpot connected, whether HubSpot export is available to this user, whether the user has signed in to HubSpot themselves, and whether the organization's connection needs to be set up again. Never carries the access or refresh token.
  - `connected` boolean: True when the user's organization has a connected portal whose token is still valid, whatever the user's permissions
  - `has_set_hubspot_integration` boolean: True when the user's organization has a connected portal whose token is still valid and the user holds the HubSpot integration permission
  - `hubspot_connected` boolean: True when the user has signed in to their organization's connected HubSpot account themselves, so their exports can use their own sign-in and set them as Contact Owner. False means the next HubSpot export should ask them to sign in.
  - `token_invalid_at` string, date-time, nullable: Set when the connection needs to be set up again

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden - the id is not the signed-in user's own

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)