Your leads cohort represents all individuals that have taken the action that you define a lead with. Creating this cohort enables a variety of lead-focused predictions, from likelihood to convert for prioritization to persona predictions for rich personalization insights.


In this tutorial, we'll show you how to:

  • Describe your Leads group formally using a cohort.

Let's dive in.

  1. You'll need a Faraday account — signup is free!

Confirm your data

Event streams

Unless you’ve already created it for another quickstart or purpose, you’ll need to add the following event stream to your account:

  • Signup

What’s an event stream?

Predicting a certain customer behavior requires historical examples of customers exhibiting that behavior. Faraday works best when that data comes in the form of “events” — specific actions or occurrences that happened at specific times.

Formulating data this way helps you define cohorts more expressively.

For example, a Customers cohort could be defined as the group of people who have all experienced a Transaction event at least once.

For more, see our docs on Cohorts, Events, Traits, and Datasets (which define how events and traits emerge from your data).


To verify, use a GET /streams request. Your response should look like this:

  "name": "Signup",
, ...}]

Make note of the IDs of the necessary streams.

If the required stream isn’t there, follow the instructions using this button, then return here to resume.

Create cohort

Create a leads cohort


Use a POST /cohorts request:

curl https://api.faraday.ai/cohorts --json '{
  "name": "Leads",
  "stream_name": "signup"

Your cohort will start building in the background. You can proceed immediately with the next set of instructions. When your cohort is done building, you’ll get an email.