# Friendbuy Destination

## About this integration

Friendbuy is a referral marketing platform. This integration helps you capture data from your sources in Friendbuy, helping you enable referral programs. For example, you might trigger a reward for a customer when a referred person signs up for your service. With this destination, you can automate referrals from source events.

[Mode How we forward source data to the destination: through Customer.io's servers or directly from our JavaScript client.](/cdp/destinations/getting-started/#connection-mode)

[Web sources Indicates whether or not this integration supports our the JavaScript client.](/cdp/sources/getting-started/#types-of-sources)

[API sources Indicates whether or not this integration supports our server libraries (Go, NodeJS, Python), API, Mobile SDK, and other data sources.](/cdp/sources/getting-started/#types-of-sources)

[Supported calls The API methods this integration supports.](/cdp/sources/source-spec/source-events/)

[Integration name The name of this integration if you want to enable or disable it in the `integrations` object.](/cdp/sources/source-spec/common-fields/#the-integrations-object)

Standard

N/A

Friendbuy (Cloud Destination)

Web

[identify](/api/cdp/#operation/identify), [track](/api/cdp/#operation/track), and [page](/api/cdp/#operation/page)

friendbuy-web

## There are two versions of this integration[](#there-are-two-versions-of-this-integration)

You’ll see two entries for Friendbuy in our [integration catalog](https://fly.customer.io/workspaces/last/journeys/integrations/all/directory), with one labeled *Web*. We typically recommend that you use the standard integration, the one *not* labeled “Web” when possible. The *web* version of this integration only works with our JavaScript client and does not pass data through Customer.io’s servers, which can make it hard to debug your integration, capture a history of events sent to the integration, and so on. Learn more about [Web integrations](/integrations/data-out/getting-started/#connection-modes).

## Getting started[](#getting-started)

1.  Go to **[Data & Integrations > Integrations](https://fly.customer.io/workspaces/last/journeys/integrations/all/directory)** and select the **Friendbuy** entry in the *Directory* tab.
    
2.  (Optional) Select the data sources that you want to connect to your outbound integration. You can always connect data sources later. We’ll only show you data sources that work with your integration.
    
3.  Configure your integration.
    
    1.  **Auth Key**: Contact your Friendbuy account manager to generate your Friendbuy MAPI key and secret.
        
    2.  **Auth Secret**: See Friendbuy MAPI Key.
        
4.  Click **Enable Destination**.
    

## Cloud mode actions[](#cloud-mode-actions)

When you’re done setting things up, you can go to the *Actions* tab to see how we map incoming data to your integration.

You may need to add actions for this integration

While we often have default triggers for actions, we don't always add those actions as defaults. You may need to add actions to make sure that you're sending all the data that you want to send to your integration. See our [actions](/integrations/data-out/actions/) page for help setting up actions.

Action

Default Trigger

Description

Track Customer

Create a new customer profile or update an existing customer profile.

Track Purchase

Record when a customer makes a purchase.

Track Sign Up

Record when a customer signs up for a service.

Track Custom Event

Record when a customer completes any custom event that you define.

## Getting started: web integration[](#getting-started-web-integration)

1.  Go to **[Data & Integrations > Integrations](https://fly.customer.io/workspaces/last/journeys/integrations/all/directory)** and select the **Friendbuy** entry in the *Directory* tab.
    
2.  (Optional) Select the data sources that you want to connect to your outbound integration. You can always connect data sources later. We’ll only show you data sources that work with your integration.
    
3.  Configure your integration.
    
    1.  **Merchant Id**: Find your Friendbuy Merchant ID by logging in to your [Friendbuy account](https://retailer.friendbuy.io/) and going to Developer Center > Friendbuy Code.
4.  Click **Enable Destination**.
    

## Web destination actions[](#web-destination-actions)

When you’re done setting things up, you can go to the *Actions* tab to see how we map incoming data to your integration.

You may need to add actions for this integration

While we often have default triggers for actions, we don't always add those actions as defaults. You may need to add actions to make sure that you're sending all the data that you want to send to your integration. See our [actions](/integrations/data-out/actions/) page for help setting up actions.

Action

Default Trigger

Description

Track Customer

`type = “identify”`

Create a new customer profile or update an existing customer profile.

Track Purchase

`event = “Order Completed”`

Record when a customer makes a purchase.

Track Sign Up

`event = “Signed Up”`

Record when a customer signs up for a service.

Track Page

`type = “page”`

Record when a customer visits a new page. Allow Friendbuy widget targeting by Page Name instead of URL.

Track Custom Event

Record when a customer completes any custom event that you define.