Freshmarketer is a Freshsales ecommerce CRM platform. It is a marketing automation tool that offers a unified marketing, sales, and CRM platform to engage your customer base and grow your business.

RudderStack supports Freshmarketer as a destination where you can seamlessly send your event data.

Getting started

Before configuring Freshmarketer as a destination in RudderStack, verify if the source platform is supported by Freshmarketer by referring to the table below:

Once you have confirmed that the source platform supports sending events to Freshmarketer, follow these steps:

1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select Freshmarketer.
2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure Freshmarketer as a destination, you will need to configure the following settings:

• API Key: Enter your Freshmarketer API key.

• Domain: Enter the subdomain of your Freshmarketer account. For example, if your organization URL is testcompany.myfreshworks.com, then the subdomain is testcompany.

• Map your events with Freshmarketer Standard Events: Use this setting to map the standard Freshmarketer events with the custom event names.

Identify

You can use the identify call to create or update your Freshmarketer contact.

RudderStack uses the Freshmarketer Upsert a Contact API to pass the relevant user information via the following parameters:

A sample identify call is shown below:

Copy
rudderanalytics.identify("1hKOmRA4GRlm", {
  email: "alex@example.com",
  firstName: "Alex",
  lastName: "Keener",
  state: "Louisiana",
  country: "USA",
  postalCode: "90009",
});

The following table lists the mappings between the RudderStack and Freshmarketer properties:

Track

You can use the RudderStack track call to track the user activities in Freshmarketer.

RudderStack supports the following track events:

Lifecycle stage

Lifecycle stage events capture the decision journey of a customer. Refer to the Freshsales documentation to create lifecycle stages in Freshmarketer.

RudderStack lets you update the status of a contact in their lifecycle stage by using either the lifecycleStageId or lifecycleStageName.

A sample track call for a lifecycle stage event is shown below:

Copy
rudderanalytics.track("eventName", {
  email: "alex@example.com",
  lifecycleStageId: 71010794467,
  phone: "+1-202-555-0146",
  owner_id: "70000090119",
});

The following table lists the property mappings betweeen RudderStack and Freshmarketer for lifecycle stage events:

Sales activities

Sales activities events can be used to track any activity related to a contact/deal/account. Refer to the Freshsales documentation to create sales activities in Freshmarketer.

RudderStack lets you create the status of a contact by using either the salesActivityTypeId or salesActivityName.

A sample track call for a sales activity event is shown below:

Copy
rudderanalytics.track("eventName", {
  salesActivityTypeId: "70000663932",
  title: "new contact",
  startDate: "2021-05-04T17:00:00+05:30",
  endDate: "2022-06-04T17:30:00+05:30",targetable_type
  ownerId: "70054866612",
});

The following table lists the property mappings betweeen RudderStack and Freshmarketer for sales activity events:

Group

The group call lets you link an identified Freshmarketer contact with a company, organization, or an account. You can also record any custom group traits like the company name, number of employees, etc.

Accounts

RudderStack uses the Upsert an Account API to create or update a sales account via the following parameters:

A sample group call is shown below:

Copy
rudderanalytics.group(
  "group01", {
    groupType: "accounts",
    name: "Alex Keener",
    phone: "1234567890",
    numberOfEmployees: 51,
    annualRevenue: 10000,
    zipcode: 90009,
    street: "6649 N Blue Gum Street",
    city: "New Orleans",
    state: "Louisiana",
    country: "USA"
  }, {
    context: {
      traits: {
        email: "alex@example.com"
      }
    }
  }
);

The following table lists the mappings between the RudderStack and Freshmarketer properties to create or update an account:

Marketing lists

Marketing lists help you group contacts into lists which you can quickly invoke for marketing campaigns and bulk emailing.

RudderStack lets you add one or more contacts to a specified marketing list. To do so, you need to provide the contact's email and listId/listName. Also, RudderStack creates a new marketing list if the listName (case-sensitive) does not exist already.

A sample group call to add a contact to a marketing list is shown below:

Copy
rudderanalytics.group("group01", {
  groupType: "marketing_lists",
  email: "alex@example.com",
  listName: "listIdX123",
});

The following table lists the property mappings between RudderStack and Freshmarketer to create marketing lists:

Type conversion and invalid format error

The following event properties accept only the number data type:

• territoryId
• leadSourceId
• ownerId
• campaignId
• contactStatusId
• lifecycleStageId
• industryTypeId
• businessTypeId
• numberOfEmployees
• parentSalesAccountid

If any of the above properties are present in any identify or group call in a different format, RudderStack will try to convert them into the number data type. If the type conversion is unsuccessful, RudderStack will give an "invalid format" error.

FAQ

Where can I find the Freshmarketer API key?

To obtain your Freshmarketer API key, follow these steps:

1. Log into your Freshmarketer dashboard.
2. Go to Personal Settings > API Settings.
3. Enable the captcha to complete the authentication process.
4. You will find your Freshmarketer API key listed under the API Authentication section, as shown: