Skip to content

Commit 9d45e35

Browse files
authored
Merge pull request #5321 from segmentio/hubspot-403
[STRATCONN-2695]- Update HubSpot doc with information regarding 403 errors
2 parents 2008372 + 4e711f6 commit 9d45e35

File tree

1 file changed

+4
-8
lines changed
  • src/connections/destinations/catalog/actions-hubspot-cloud

1 file changed

+4
-8
lines changed

src/connections/destinations/catalog/actions-hubspot-cloud/index.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -34,14 +34,11 @@ HubSpot Cloud Mode (Actions) provides the following benefits over the classic Hu
3434
- **Support for custom behavioral events**. Send [custom behavioral events](https://developers.hubspot.com/docs/api/analytics/events){:target="_blank"} and event properties to HubSpot.
3535
- **Create records in custom objects**. Use your Segment events to create records in any standard or custom object in your HubSpot account.
3636

37+
> note ""
38+
> A HubSpot Enterprise Marketing Hub account is required to send Custom Behavioral Events.
3739
3840
## Getting started
3941

40-
> info ""
41-
> Before you begin, you need to generate a Private App in HubSpot. To generate a Private App from the HubSpot dashboard, navigate to **Integrations > Private Apps**.
42-
>
43-
> Segment requires the following scopes: `business-intelligence`, `crm.objects.contacts.read`, `crm.objects.contacts.write`, `crm.schemas.contacts.read`, `crm.objects.companies.read`, `crm.objects.companies.write`, and `crm.schemas.companies.read`. For more information, see HubSpot's [Private Apps](https://developers.hubspot.com/docs/api/private-apps){:target="_blank"} article.
44-
4542
1. From the Segment web app, navigate to **Connections > Catalog**.
4643
2. Search for **HubSpot Cloud Mode (Actions)** in the Destinations Catalog, and select the destination.
4744
3. Click **Configure HubSpot Cloud Mode (Actions)**.
@@ -74,12 +71,11 @@ Segment provides prebuilt mappings for contacts and companies. If there are othe
7471
### How do I send `Page` events to HubSpot?
7572
The [Track Page View action](/docs/connections/destinations/catalog/actions-hubspot-web/#track-page-view) is only available in [HubSpot Web (Actions) destination](/docs/connections/destinations/catalog/actions-hubspot-web/). As a workaround, with HubSpot Cloud Mode (Actions) destination, you can use the [Custom Behavioral Event](/docs/connections/destinations/catalog/actions-hubspot-cloud/#send-custom-behavioral-event) to send Page events to Hubspot. You'll need to [follow Hubspot's instructions](https://knowledge.hubspot.com/analytics-tools/create-custom-behavioral-events-with-the-code-wizard){:target="_blank"} to create a custom behavioral event for `Page Viewed` in HubSpot.
7673

77-
7874
### Why aren't my custom behavioral events appearing in HubSpot?
7975
HubSpot has several limits for custom behavioral events, including a limit on the number of event properties per event. Each event can contain data for up to 50 properties. If this limit is exceeded, the request will fail. See [HubSpot documentation](https://knowledge.hubspot.com/analytics-tools/create-custom-behavioral-events#define-the-api-call){:target="_blank"} for other limits.
8076

81-
> note ""
82-
> A HubSpot Enterprise Marketing Hub account is required to send Custom Behavioral Events.
77+
### How do I resolve a `403` error for custom behavioral events?
78+
`403` errors indicate that Segment is unable to send your event to HubSpot because the account connected doesn't have sufficient permissions. If you're observing `403` errors for Custom Behavioral Events, ensure that your HubSpot account is a `HubSpot Enterprise Marketing Hub` account. After upgrading your account to `Enterprise Marketing Hub`, **Reauthorize** from the **Settings** page of your destination to resolve the `403` errors.
8379

8480
### Why can't I set an entire object for the Other properties field?
8581

0 commit comments

Comments
 (0)