This guide is available only for companies that signed up for a FirstPromoter trial before 31st March 2021. For sign ups after this date, please follow the instructions on the integration wizard.

Step 1)

Make sure the visitor tracking script is inserted on all marketing pages, including on the pricing page. This script is found on your FirstPromoter account, Getting Started section > click "Quick setup" > click "View setup instructions".

Step 2)

If you are NOT using Chargebee Drop-in JS script (the one that shows their popup checkout), skip this step and use our sign-up tracking script or API like it's specified on the setup instructions page (the page from step 1) to track the signups first and proceed directly to step 3 below (setting up the Chargebee webhook).

If you are using Chargebee popup checkout, you won't be able to get the customer details through Javascript (our signup tracking script won't work in this case) so we need to use another approach to match the customer with the tracking id stored in the browser cookie:

a)  Set up a text custom field for the Customer object on Chargebee called "tid". Click here for more information about Chargebee custom fields. 

b) Copy-paste the following code on your pricing page. Make sure it's added AFTER Chargebee JS script  which looks like this <script src="" data-cb-site="yoursite"></script>

Tracking script to copy-paste:

var chargebeeTrackFunc=function(fprom) {
    var tid =;
    var chargebeeInstance;
       chargebeeInstance = Chargebee.getInstance();
    if (tid && chargebeeInstance){
        var cart = chargebeeInstance.getCart();
    if (tid){
if (window.$FPROM)

Step 3)

Make sure you are on FirstPromoter Chargebee integration setup, either by going to Settings > Integrations > Chargebee > Setup or from the Quick Setup Wizard from Getting Started section. Make sure you see this:

Set Chargebee Webhooks

  1. Login to Chargebee and go to Settings > Webhook Settings

  2. Click 'Add new webhook' button on top right(if it's visible)

  3. On Webhook name set something like 'FirstPromoter'

  4. On the Webhook URL, paste the Webhook Endpoint URL value from FirstPromoter integration setup

  5. Select API version - V2

  6. Check 'Exclude card object from webhook call'

  7. Click 'Create Webhook'

  8. Back to FirstPromoter, on 'Site' field, enter your Chargebee subdomain(look at the URL bar, if your URL is your site is 'mycompany')

  9. Click 'Save'

Did this answer your question?