You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/connections/destinations/catalog/actions-hubspot-cloud/index.md
+5-9Lines changed: 5 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,14 +34,11 @@ HubSpot Cloud Mode (Actions) provides the following benefits over the classic Hu
34
34
-**Support for custom behavioral events**. Send [custom behavioral events](https://developers.hubspot.com/docs/api/analytics/events){:target="_blank"} and event properties to HubSpot.
35
35
-**Create records in custom objects**. Use your Segment events to create records in any standard or custom object in your HubSpot account.
36
36
37
+
> note ""
38
+
> A HubSpot Enterprise Marketing Hub account is required to send Custom Behavioral Events.
37
39
38
40
## Getting started
39
41
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
-
45
42
1. From the Segment web app, navigate to **Connections > Catalog**.
46
43
2. Search for **HubSpot Cloud Mode (Actions)** in the Destinations Catalog, and select the destination.
@@ -66,20 +63,19 @@ Search Fields to associate | This finds a unique record of custom object based
66
63
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.
67
64
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**.
68
65
69
-
## FAQ and troubleshooting
66
+
## FAQ and troubleshooting
70
67
71
68
### How do I send other standard objects to HubSpot?
72
69
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.
73
70
74
71
### How do I send `Page` events to HubSpot?
75
72
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.
76
73
77
-
78
74
### Why aren't my custom behavioral events appearing in HubSpot?
79
75
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.
80
76
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.
83
79
84
80
### Why can't I set an entire object for the Other properties field?
0 commit comments