Quick Start Guide
Welcome to Customer.io! While the platform offers plenty of features and options, this guide breaks down the basic things you need to set up to help you get started as quickly as possible. You’ll create a workspace, import people, and set up your messaging channels!
Are you new to Customer.io?
This page follows the basic setup path in Customer.io, so you can get started and follow along in the product. If you’re not using Customer.io yet and just looking for more in-depth information about Customer.io, check out the other pages in this section!
How Customer.io works
At its core, Customer.io helps you send messages to people, so you can foster a relationship with your audience to achieve your goals. The diagram below shows in a very simple sense, how it works:


Customer.io is incredibly flexible in helping you achieve your messaging goals. Before you begin, ask the following questions. Your answers can help you understand what you need to do to “set up” Customer.io!
- Where do your “people” come from—your website, mobile app, backend database, etc? These are the data source(s) you should connect to Customer.io.
- What kinds of messages you want to send? These are the message channels you need to set up.
- What goals will your messages accomplish? These can help you determine the types of segmentsA segment is a group of people in your audience that you want to target with campaigns, messages, etc. You can join groups of people manually, or by attribues and event data. and campaignsA series of actions that you perform for each person who matches criteria. Campaigns typically send people a series of messages, but you can also use campaigns to send webhooks, update attributes, etc. you build!
What browsers do we support?
We actively test our user interface with latest two major versions of Google Chrome, Mozilla Firefox, Microsoft Edge, and Safari.
You might find that a different browser or an earlier version works for you. But, if you run into trouble in our UI, you may want to update your browser or switch to a supported platform to make sure that you haven’t encountered a browser-based issue.
Get started
When you start setting up Customer.io, we provide you with a Setup List. You don’t have to do everything on the list, but you must do the following things before you can really take advantage of Customer.io:
- Create an account and at least one workspace.
- Add people to your workspace.
- Set up the types of messages you want to send.
Create your workspace
After you create your account, you’ll make a workspace. You can think of a workspace as a container for your people, data, messages, etc. You can have more than one workspace, but, in general, you won’t share information across workspaces.
If you’re new to Customer.io, we encourage you to use the default settings. They support most use cases and you can change them later!


Add people to your workspace
To get started quickly, you can go to the People page in your workspace and add a person with a few attributes to test with, or upload a CSV of people.


But, to get the most out of Customer.io, you’ll probably want to set up one or more of the following integrations to identifyThe Customer.io operation that recognizes a person. When you call the method or API to identify a person, Customer.io either adds a person if they don’t exist in your workspace, or otherwise updates/associates data with a person. Activities before a person is identified may be attributed to an anonymous ID. people and capture their events from different sources:
- Install the JavaScript Snippet on your website.
- Import people who fill out forms on your website.
- Use Segment, and pipe information from other sources into your workspace.
- Set up a database/reverse-etl integration, and regularly add or update people directly from your back-end.
& newsletters]-.->b((People)) b-.->c end d[(Website)]-.->i[JS snippet]-.->1 e[(Backend system)]-.->f[Segment]-.->1 g[(Database)]-.->j[database sync]-.->1 h((You))-.->k[Upload CSV]-.->1 h-.->l[Manually add people]-.->1
What is a person in Customer.io?
It might help to understand what we mean by a “person”. In Customer.io, you’ll represent a person with three major things: identifiers, attributes, and events.
- IdentfiersThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace.: the values that make people unique in your system—like a database
id
oremail
address. - AttributesA key-value pair that you associate with a person or an object—like a person’s name, the date they were created in your workspace, or a company’s billing date etc. Use attributes to target people and personalize messages.: the things you know about people, like their names, interests, etc.
- EventsSomething that a person in your workspace did. Events can trigger campaigns, add people to segments, etc. You can access event properties in liquid with
{{event.<property>}}
: the things that people do. You can use events to trigger campaigns in response to your audience’s activity in your system.
Before you add people, think about the attributes and events you want to track
You’ll use attributes and events to group people into segmentsA segment is a group of people in your audience that you want to target with campaigns, messages, etc. You can join groups of people manually, or by attribues and event data., determining who goes through your campaignsA series of actions that you perform for each person who matches criteria. Campaigns typically send people a series of messages, but you can also use campaigns to send webhooks, update attributes, etc. and who you send messages to. Plan out your “groups” of people and the types of messages you want to send to make sure that you gather the right data in Customer.io!
Add yourself as a test person
If you’re new here, you might want to add yourself to your workspace, so you can test a campaign against yourself and get a feel for Customer.io without using your customers or users. Later in this guide, we’ll use your test person in a live segment and campaign.
- Go to the People page, click Add People and select Add a Person.
- Set your ID and email address. To make it easy, you might assign your test user an ID of
1
. - Add attributes to your person, like first_name and last_name. These are the values you’ll use to target yourself and personalize messages!
- Click Save Changes when you’re done.


Set up message channels
Before you can send messages, you need to configure the types of messages you want to send: email, push, in-app, Twilio SMS, or Slack. You can start with just one channel and add new ones later by going to Settings > Workspace Settings and click Get Started on the channel(s) you want to add.
After you set up a message channel, you can start using it in campaigns!


- Twilio SMS: If you already have a Twilio account, you can add your Account SID and an Auth Token, to send SMS messages from your workspace.
- In-App Messages: Integrate our SDKs and then enable In-App Messaging in your workspace. Then you’ll be able to send messages to your app’s users from any campaign or broadcast!
- Slack: Just Enable Slack and authorize Customer.io to send messages to your Slack workspace.
You can send webhooks too!
A webhook is a call to an external system. You can use webhooks to fetch additional data that you want to use in your campaigns, trigger actions in an outside service, and so on!
What’s next?
If you’re ready, you can start creating live campaigns and send people messages. If you’re curious about other areas of Customer.io, check out the rest of our Getting Started section to learn more about the platform.