Segment integration

Activating Segment integrations

To enable Segment integrations, click on Integrations (plug icon) on the left of the administration, then locate, and click on Setup.

Sending Product Fruits events to

We can send different Product Fruits events from Product Fruits to For instance, events such as when a user completes a tour, when a checklist is dismissed, etc. The list of supported events is here.

Please note that this integration uses JavaScript SDK, which must be installed in your application, and the analytics variable must be available on the JavaScript window object. We call the method.

Sending events and user information to Product Fruits

This feature is available in the Boost plan.

We support integration through their Webhook destination. Before you use this, please check the User tracking modes article.

Open the integration box and activate the integration. It will generate a Webhook URL and a Webhook Secret.

Then go to, create a new webhook destination and enter both the webhook URL and webhook secret into the settings.

Please note, webhook settings in can be a little bit confusing. Check that your values are entered into the correct fields as shown in the following screenshot.. Don't forget to activate the webhook by clicking on the blue switch.

User matching - important

What is important is that Product Fruits and must share the same user identity. Without this, we would not be able to pair the information received through the webhook to the right user.

The Product Fruits username field should match the userId field of (this is the value you pass to analytics.identify(xxx)). If this is not true, you will most likely get duplicated users in Product Fruits. web JS SDK

If you use the JavaScript SDK to identify users, you must call analytics.identify('some_user') somewhere in your code to initialize user information. You can also include additional information. For instance, e-mail, first name, last name, etc. 


// The most basic call. We are sending userId to - this must match to the username field in Product Fruits

// We can also pass email; then PF will match this to the email field in Product Fruits
analytics.identify('some_user', { email: '', firstname: 'John' })

The userId in this case is the first parameter of the identify method. REST API

If you are sending data through the Segment.IO REST API, provide the userId field in the request payload. 

For example, you would send a POST request to with this payload:

  "userId": "019mr8mf4r", // this must match to the username field in Prodcut Fruits
  "event": "Item Purchased"