How to set up Stape Conversion Tracking HubSpot app
Updated Apr 22, 2026
The Stape Conversions Tracking HubSpot CRM app transfers Contact status updates from HubSpot CRM to Meta, Google Ads, or any other platform you choose. This data can then be used to optimize ad campaigns and target audiences with higher conversion intent.
App installation
Install the Stape Conversion Tracking HubSpot app on HubSpot's marketplace.
Choose the account to install the app into:
1.3 Confirm access requested by the app and hit “Connect app”:
You will see the following success screen:
Go back to HubSpot CRM and pick an account you need. Then go to Settings → Integrations → Connected Apps.
On the next page click “Add Settings”:
Integration methods: CAPI Gateway, Signals Gateway, server GTM or Customer Match
❗Please note before starting: Stape’s app supports multiple integrations simultaneously. Each integration method has its own tab with an “Activate integration” toggle; switch it on for the integrations you want to send data to.
Integration method depends on your tracking setup and goals, and/or on your current experience with Stape. Click on the section below that corresponds to the tracking method you use:
Before you start
Make sure you have an active Stape account with Meta Conversions API Gateway
If you don't have an account on Stape, please create one or log in if you already have. In the main menu click More Gateways → Meta CAPIG → Create CAPIG on the top right.
Add name, email, and server location for new CAPIG. Then, choose the subscription plan and add billing details.
After creating Meta Conversions API Gateway in your Stape account, connect your Meta Dataset (Pixel) - just click Add data source → authorize in Meta → select the Business Manager and Dataset (Pixel) you want to connect.
To increase the events match quality, please enable Automatic advanced matching.
| For more detailed instructions, check Stape's article on how to set up Meta Conversions API Gateway. |
App setup
The setting process can be divided into two parts:
- Meta and Stape accounts data
- HubSpot CRM fields
Meta and Stape accounts data
You will need to fill in the following field:
- Integration - switch Activate toggler on to enable the current integration (tab) to run in the background.
- Meta Dataset (Pixel) ID - a unique identifier that is used to configure integrations and view events in Events Manager. You can find it in your Meta account in Data Sources' Settings tab. See the detailed instruction on how to find Meta Dataset (Pixel) ID.
- CAPIG API Key - an alphanumeric string value that is needed for app identification. Find CAPIG API Key in the CAPIG settings section of your Stape account. See the detailed instructions on where to find CAPIG API Key.
HubSpot CRM fields
Next you need to map your CRM fields to conversion event parameters.
- (Optional) Pick a field where Meta Lead ID is stored.
- Configure additional User data you'd like to send to Meta, by choosing a parameter in the left dropdown and selecting an appropriate field in the right-side one.
- Application sends conversion Events based on statuses of your Contacts, whenever a deal reaches a status you define, a corresponding event will be sent towards your Meta Dataset (Facebook Pixel). So we need to configure it by choosing one of two approaches:
- In the left-side dropdown, select a Contact stage to trigger an event; in a box to the right, type the event name you'd like to send to Meta.
- Select the Send all statuses checkbox if you want to send all Contacts stages as events to Meta. Events are then named automatically and consist of a Contact status name. You can also select stages to ignore in this case.
Once done, click Save and Connect. Once you see a success message your installation is complete and the application will send conversion events in the background based on your settings.
Before you start
Make sure you have an active Stape account with Signals Gateway
If you don't have an account on Stape, please create one or log in if you already have. In the main menu click Signals Gateway → Create Signals Gateway on the top right.
Add name, email, and server location for new Signals Gateway. Then, choose the subscription plan.
| For more detailed instructions, check Stape's article on how to configure Signals Gateway. |
App setup
The setting process can be divided into two parts:
- Signals and Stape accounts data
- HubSpot CRM fields
Signals and Stape accounts data
You will need to fill in the following fields:
- Integration - turn on the Activate toggle to allow the current integration (tab) to run in the background.
- Signals Gateway Pixel - a unique identifier that is used to configure integrations and view events in Signals Gateway. You can find it in your Signals Gateway account in the Data Sources tab. See the detailed instruction on how to find Signals Gateway Pixel ID.
- Signals Gateway API Key - an alphanumeric string value that is needed for app identification. Find Signals Gateway API Key in the Gateway settings section of your Stape account. See the detailed instructions on where to find Signals Gateway API Key.
HubSpot CRM fields
Next you need to map your CRM fields to conversion event parameters.
- (Optional) Pick a field where Meta Lead ID is stored.
- Configure additional User data you'd like to send to Signals Gateway, by choosing a parameter in the left dropdown and selecting an appropriate field in the right-side one.
- Application sends conversion Events based on statuses of your Contacts, whenever a deal reaches a status you define, a corresponding event will be sent towards your Signals Gateway Pixel. So we need to configure it by choosing one of two approaches:
- In the left-side dropdown, select a Contact stage to trigger an event; in a box to the right, type the event name you’d like to send to Signals Gateway pipeline.
- Select the Send all statuses checkbox if you want to send all Contacts stages as events to Signals Gateway pipeline. Events are then named automatically and consist of a Contact status name. You can also select stages to ignore in this case.
Once done, click Save and Connect. Once you see a success message your setup is complete and the application will send conversion events in the background based on your settings.
Before you start
Make sure you have an active Stape account with a server GTM container hosted on Stape.
If you don't have an account on Stape, please create one or log in if you already have. In the main menu click sGTM → Create container on the top right.
Add your container name, Container Configuration that you copied from your Google Tag Manager Server Container, and select server location. Click Create Container.
| For more detailed instructions, check Stape's article on how to set up a Google Tag Manager server container. |
App setup
The setting process can be divided into two parts:
- Stape accounts data
- HubSpot CRM fields
Stape account data
You will need to fill in the following field:
- Integration - turn on the Activate toggle to allow the current integration (tab) to run in the background.
- Container API Key - an alphanumeric string value that is needed for app identification. Find Container API Key in the Container settings section of your Stape account. See the detailed instructions on where to find Container API Key.
HubSpot CRM fields
Next you need to map your CRM fields to conversion event parameters.
- (Optional) Pick a field where Meta Lead ID is stored.
- Configure additional User data you'd like to send to server GTM, by choosing a parameter in the left dropdown and selecting an appropriate field in the right-side one.
- Application sends conversion Events based on statuses of your Contacts, whenever a deal reaches a status you define, a corresponding event will be sent towards your server GTM container. So we need to configure it by choosing one of two approaches:
- In the left-side dropdown, select a Contact stage to trigger an event; in a box to the right, type the event name you'd like to send to server GTM.
- Select the Send all statuses checkbox if you want to send all Contacts stages as events to server GTM. Events are then named automatically and consist of a Contact status name. You can also select stages to ignore in this case.
Once done, click Save and Connect. Once you see a success message your installation is complete and the application will send conversion events in the background based on your settings.
Configure sending data to the required platforms
With the current setup, the app will send events to your server GTM container, but to distribute them to platforms like Meta, TikTok, Google Ads, or any other, you need to configure the CAPI tags inside GTM to fire accordingly.
1. Configure the Data Client to claim the JSON requests sent from the CRM app. Go to the Templates → click “New” → upload the Data Client template you’ve previously downloaded from the Github.
2. Go to the Clients section of your sGTM container → click “New” → select Data Client. That’s basically it, your configuration will look like in the screenshot below. Click “Save”.
2. Select the platforms you need to send data to from sGTM. While setting up server-side tracking with sGTM, you might have already configured the CAPI tags for the required platforms, for example:
Or any other tags for platforms that support server-side tracking. You will need to use them to configure sending data from your CRM to the required platforms.
To give you an understanding of how to configure the tags this way, we will take the Facebook platform as an example. You should map the events according to the requirements of the platforms you use.
4. Create a new Facebook CAPI tag. Go to the Tags section in sGTM → add “Facebook Conversion API” as tag type.
5. Configure the tag.
Event Name Setup Method: Override
- Event Type: Custom. Select a built-in variable “Event name”.
- Action Source: System Generated.
- Add Pixel ID and generate API Access Token: for the detailed instructions on how to find these values, please refer to our guide on where to find Meta Pixel ID and API Token.
Here is an example of how your configuration will look at this point:
- User data section: select properties from the drop-down list - Lead ID, Browser ID, Click ID. These three are basic.
For each property, add a variable that will take the appropriate value from the request sent from the CRM app.
Create a following variable for Lead ID:
- Variable Type: Event Data
- Key Path: lead_id
Create two different variables for Browser ID and Click ID:
- Variable Type: Event Data (for both), as the IDs will be retrieved from the event sent from CRM, not from the cookie.
- Cookie Name: fbp (for Browser ID variable) and fbc (for Click ID variable)
Here is an example of the user data section configuration:
- Custom data section: add a few custom fields to identify the source of the event.
Event_source property name with crm value.
lead_event_source - as property value, add a variable with the following configurations:
- Variable Type: Event Data
- Key Path: lead_event_source
Here is how this configuration will look like in the tag:
6. Add a trigger for a tag.
Use the following configurations:
- Trigger type: Custom
- This trigger fires on: Some events
Besides, add the following conditions for a tag to trigger:
- Client Name equals Data Client
- Action Source equals system_generated
The variable for action source must have configurations as on the screenshot below:
- Event Source equals crm
Configure the variable for the event source as shown in the screenshot:
As a result, your trigger will look similar to the example from the screenshot below:
7. Test the setup.
Since it is, in fact, a webhook that is sent from CRM to the server GTM, you can refer to the article on debugging incoming webhooks in server GTM for the detailed instructions.
If you are using Customer Match as a configuration method for the Stape Conversion Tracking HubSpot app, once configured, a new Customer List will be created in Google Ads. Please note, only Customer Lists created automatically by the Stape connection are supported.
Manually created or pre-existing lists in Google Ads will not be populated. For more info on Customer List, please check our article.
Before you start
Make sure you have an active Stape account with a server GTM container hosted on Stape.
If you don't have an account on Stape, please create one or log in if you already have one. In the main menu, click sGTM → Create container on the top right.
Add your container name, Container Configuration that you copied from your Google Tag Manager Server Container, and select the server location. Click Create Container.
| For more detailed instructions, check Stape's article on how to set up a Google Tag Manager server container. |
App setup
The setting process can be divided into two parts:
- Stape and Google Ads accounts data
- HubSpot CRM fields
Stape and Google Ads account data
You will need to fill in the following fields:
- Integration - switch Activate toggler on to enable the current integration (tab) to run in the background.
- Container API Key - a string used for app identification. Find Container API Key in the Container settings section of your Stape account. See the detailed instructions on where to find Container API Key.
- Google Ads Operating customer ID - the ID of the Google Ads account where the Customer List will be created or updated. To get it, sign in to your Google Ads account → in the top right corner, click on your picture → copy the value.
Please make sure to remove hyphens before using the string as the Operating customer ID.
- Google Ads customer ID - stands for the ID of the account that you're using for authorization. Based on the type of account, you should copy the following values.
- If you're using your customer account, use the customer account ID.
- If you access the customer account through a manager account, use the manager account ID.
Please make sure to remove hyphens before using the string as the customer ID.
HubSpot CRM fields
Next, you need to map your CRM fields to audience member identifiers.
- User data - choose the data you want to fill the Customer List in Google Ads with, and specify user and ads data consent status from the drop-down list.
Please note: Address data will be included only if all four fields (First Name, Last Name, Region, Postal Code) have values.
- Actions & triggers - choose Action, Opportunity Status, and name a Customer List to be synced to. After configuring Customer Match in the HubSpot app, a Customer List will be created in Google Ads.
Please note: stape_ is always appended, and the name of the list must always start with "stape_," e.g., stape_hubspot_purchasers.
- Backfill - if you check this box, the app will sync existing contacts using the settings in the app above. When the unchecked box is selected, it will sync only new contacts that reach the configured statuses. Unchecking later doesn’t remove contacts already synced.
Once done, click Save and Connect. Once you see a success message, your installation is complete, and the application will send conversion events in the background based on your settings.
Settings editing
If you have some changes in the funnel or you want to change the events sent to your CAPI Gateway, server GTM container, or Signals Gateway, you can always edit your app configuration.
To do this, go to Settings → Integrations → Connected Apps and follow the steps from section 1 of this manual.
FAQ
- Is there a subscription involved to use the application?
Application is distributed for free, but you will need a functioning Stape account with active CAPI Gateway, GTM Container or Signals Gateway. It depends on your tracking setup and/or current experience with Stape.
- How does the app trigger conversion events?
Application will react to status changes of your Contact entities. Triggers are configured in app settings.
- How can I make sure the app actually works?
With CAPI Gateway integration you should see events you’ve configured in your Events Manager. Please note the user interface may take up to 30 min to reflect most recent events sent.
With Signals Gateway integration you should see events you’ve configured in your Signals Gateway Data Source. Please note the user interface may take up to 30 min to reflect most recent events sent.
With server GTM integration the assumed approach for debugging is webhooks.
- Do you provide templates for server GTM integration?
Yes, you can find a pre-built server container template in our GitHub.
Comments