Freshmarketer Destination

Segment makes it easy to send your data to Freshmarketer (and lots of other destinations). Once you've tracked your data through our open source libraries we'll translate and route your data to Freshmarketer in the format they understand. Learn more about how to use Freshmarketer with Segment.

This destination is maintained by Freshmarketer. For any issues with the destination contact us at

Getting Started

You can create and update Freshmarketer Contacts through Segment. We support identify method. Once your Segment source starts receiving data, you can send them to Freshmarketer by enabling this destination. You can enable it from Freshmarketer Admin Settings -> Third Party Integrations. Select the Segment source from which data has to be forwarded to Freshmarketer.

You will have to provide the admin API key of your Freshmarketer product.


You can use 'Identify' to create a contact when a website visitor fills a webform. When you identify a user, we’ll pass that user’s information to Freshmarketer.

User ID

userId is a mandatory field which is used to identify the contact in Freshmarketer. It is mandatory that email has to be a part of traits. If userId is email Id, then send that email Id in both userId and traits.

Sample Identify request payload

  "userId": "37587cgeo0189",

  "type": "identify",
"traits": {
"first name": "John",
"last name": "Doe",
"email": ""

By default, every new identify is created as a contact. If the userId given is already present in the contact list in Freshmarketer, it will be treated as an update. If you want to update the existing user data, pass the corresponding userId with all the traits with the updated value. On updating, if any of the traits (that is added during contact insertion) is missed while updating, then that trait will be set as empty.


Traits are pieces of information you know about a user that is included in an 'identify' method.

Default Traits

You can find default list of field names in Settings - > Custom fields for field mapping. 

All attributes that are a part of traits should correspond to the Field Label of those fields in Freshmarketer. Attributes that are not mapped with their corresponding fields are ignored.

Custom Traits

As part of traits, you can send custom fields created in Freshmarketer by using their Field Label. Also, custom fields will not be automatically created. You have to create them with the exact name and type to map to your field in Freshmarketer before proceeding to send data from Segment. 

Here is how you can create a custom field in Freshmarketer.


Segment lets you change these destination settings via your Segment dashboard without having to touch any code. At any time you can disable this integration by toggling the state inside Freshmarketer product under Settings -> Segment Integration.

API token

You can find your Freshmarketer API token in the Freshmarketer product under Admin Settings -> API Settings.