Skip to content

Commit 77420be

Browse files
[STRATCONN-2695]- Update doc with info to handle 403 errors
1 parent d46e61e commit 77420be

File tree

1 file changed

+5
-9
lines changed
  • src/connections/destinations/catalog/actions-hubspot-cloud

1 file changed

+5
-9
lines changed

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

Lines changed: 5 additions & 9 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)**.
@@ -66,20 +63,19 @@ Search Fields to associate | This finds a unique record of custom object based
6663
ObjectType to associate | To associate the newly created and updated custom object record with another object type, select the object type you want it to be associated with.
6764
Association Label | Select an association label between both the object types. From the HubSpot Dashboard, you can create associations between any type of object. To create an association label: <br>1. Log in to the [HubSpot Dashboard](https://app.hubspot.com/){:target="_blank"}. <br>2. Go to **Data Management > Objects > Custom Objects**. <br>3. Go to the **Associations** tab and click **Create association label**.
6865

69-
## FAQ and troubleshooting
66+
## FAQ and troubleshooting
7067

7168
### How do I send other standard objects to HubSpot?
7269
Segment provides prebuilt mappings for contacts and companies. If there are other standard objects you would like to create records in, please use the **Create Custom Object Record** action. For example, to create a deal in HubSpot, add a mapping for Create Custom Object Record, set up your Event Trigger criteria, and input a literal string of "deals" as the Object Type. You can use the Properties object to add fields that are in the [deals object](https://developers.hubspot.com/docs/api/crm/deals){:target="_blank"}, such as `dealname` and `dealstage`. The same can be done with other object types (for example, tickets, quotes, etc). Ending fields that are to go to HubSpot outside of the properties object isn't supported. This includes sending [associations](https://developers.hubspot.com/docs/api/crm/associations){:target="_blank"}. Please note, Segment only supports creating new records in these cases; updates to existing records are only supported for contacts and companies.
7370

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+
### I'm seeing a `403` errors for custom behavioral events. How do I resolve them?
78+
`403` errors indicate that Segment was unable to send your event to HubSpot because the account connected doesn't have sufficient permissions. If you are observing 403s for Custom Behavioral Events, please ensure that your HubSpot account is a `HubSpot Enterprise Marketing Hub` account. After upgrading your account to `Enterprise Marketing Hub`, please **Reauthorize** from the `Settings` page of your destination to resolve `403` errors.
8379

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

0 commit comments

Comments
 (0)