Workspaces in Customer.io
Workspaces are a way of working with multiple products, sites or apps from a single Customer.io account. Everyone starts with one (its name is the same as your account name), and you can add or remove them as needed.
When you set up a new workspace, we ask how you want to identify people. This determines the values (identifiers) that you can use to identify and represent people. These values are unique: each identifier represents an individual person; two people cannot have the same identifier.
If you use the Email or ID setting, you can identify new people with either identifier and set the other identifier later. This path can be especially helpful for cases where you identify people before they become users or customers (leads) by email address and then assign IDs to people when they become customers or users—when they generate an ID—later.
You cannot change this setting after you create your workspace, but you can create multiple workspaces with different identifier settings. You might have different workspaces to represent different organizations within your company, different supersets of people, and so on.
When you create your workspace and pick your identifiers, you should consider whether or not you might associate an email address with more than one person. If multiple people in your workspace might use the same email address, you would not want to use
For most use cases, we recommend that your workspace identifies people by Email or ID. If you created your workspace before June 2021, or started from a workspace with different identifier settings, you can enable both identifiers.
Before you enable new identifiers, we validate the people data in your workspace to make sure that your new identifier value(s) are unique and appropriate. See the section below to prepare your workspace before you enable new identifiers.
To enable both email and ID as identifiers:
- Go to Settings > Workspace Settings and click General Workspace Settings.
- Click Change Configuration.
- Carefully read about the things that will change for your workspace. You cannot undo this change. When you’re ready, click Change configuration.
- At this step, we’ll validate your people-data to make sure that you can safely enable both email and ID as identifiers. If your workspace passes validation checks, your new identifiers are enabled and you can start identifying people by email or ID.
If your workspace encounters validation errors—duplicate, invalid, or suppressed email addresses—we’ll email you and provide an export of duplicate or invalid profiles that you have to resolve before we can finish enabling your new identifiers. You’ll find the export under Data & Activity > Exports.
The most common issue when changing identifiers is duplicate identifiers. Go here to learn how to remove duplicates.
Before we can enable new IdentifiersThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace. (email or ID), we validate your people-data to make sure that the identifier(s) you want to enable contain unique, appropriate values.
If we encounter validation errors when you attempt to change your workspace configuration, we’ll email you a list of the profiles you must fix before you can enable new identifiers.
|Validation Error||Fix for Migration|
|Multiple profiles have the same email address||Delete all but one of the profiles containing the same email attribute, or change the email attribute so that all profiles have a unique email address.|
|Profile has an invalid email address||Delete the profile or correct the email address.|
|Profile has a suppressed email address||Delete the profile containing the suppressed email address or change the email address to a value that has not been suppressed.|
|Profile has an ID that is an email address, and the ID does not match the
When you change your workspace configuration so that
We provide a CSV export of duplicate profiles (and other validation errors) under Data & Activity > Exports. You can use this list to find and remove duplicate profiles in your workspace and finish enabling email as an identifier.
When resolving duplicates, we recommend that you keep the oldest profile (using the
_created_in_customerio_at attributes) and remove newer profiles. As a part of this process, you’ll remove profiles that you want to keep in your workspace from the CSV, so that your CSV contains only the profiles that you want to remove from your workspace. Then you’ll use that CSV as a manual segment to target and remove the duplicate profiles.
- Go to Data & Activity > Exports and download the export of validation errors that was created when you tried to change your workspace configuration.
- Identify duplicates in the CSV and remove the rows representing people that you want to keep in your workspace. Your CSV should contain only people that you want to remove from your workspace.
- Go to Segments and create a new manual segment. Upload the list of users you want to remove as your segment.
- Go to the People page and click adding filters.
- Click Add segment condition and select the segment representing the duplicate people that you want to remove.
- Click Select all
people, and then click Delete.
When you’ve finished removing duplicate profiles, you can try to enable both email and ID as identifiers in your workspace again.
When you enable email or ID as identifiers, you may notice slightly different behaviors from other workspace types.
- Reporting Webhooks: the
customer_idkey is null if you add a person without an ID (by email only). You should update your endpoints to use the new
identifiersobject. See our webhook documentation for more information.
- Segment Source events: After you migrate, message opens, clicks, etc. are only sent to Segment for profiles that have an
id. When you send messages to people without an ID, message metrics are not sent to Segment. Contact email@example.com to request a change in handling source events.
- If you had an email-only workspace, IDs are no longer auto-generated: In workspaces where email was the only identifier, people auto-generated IDs when you added them by email. In your email or ID workspace, this will not happen. When you add someone by email, their ID is null.
Click your workspace in the upper left corner and then click Manage all workspaces to see a list of your workspaces. From here you can add, edit or delete workspaces (if you have more than one).
- Click your workspace in the upper left corner and then click Manage all workspaces to go to the Workspaces page.
- Click Add.
- Give your new workspace a name and a custom color to help you differentiate between your workspaces.
- Set the unique Identifiers for people in your workspace. In most cases, you should keep the default setting:
- Set the default send behavior for the workspace:
- Send messages normally: All messages send as defined in your workflow.
- Test email delivery: Emails will send to a defined test address; other messaging types (Slack, webhooks, etc.) send as normal.
- Never send messages: Message delivery is disabled.
- Select the team members who can manage and access the new Workspace. You can’t disable access to a Workspace for an Admin; Admins can access all Workspaces in an account.
- Click Save.
When you’ve finished adding your workspace, you can switch between workspaces from the main navigation bar.
To edit an existing Workspace, go to the Workspaces page and click ‘Edit’ in the Manage settings:
You can change your Workspace’s name, delivery settings or access permissions for team members. You can also change the color assigned to the Workspace to help you differentiate between them.
To remove a Workspace, go to the Workspaces page and click Delete.
You must type your Workspace’s name (case-sensitive) to delete it.
Deleted workspaces are not recoverable.
If you isolate workspaces by project, client, app, or something else, you can limit your teammates' access to certain workspaces.
Admins can access all Workspaces in the account. You cannot disable an admin’s access to a workspace.
No information is shared between Workspaces.
Workspaces are essentially separate instances of Customer.io. Each Workspace has its own people, campaigns, metrics, and other data.
You are billed for the number of profiles you have and messages you send across all Workspaces on your account.
Workspaces are completely separate instances of Customer.io, each with their own people and associated data. This prevents sharing information and potentially messaging the wrong person. However, you can copy workflow actions across Workspaces).
Although not designed specifically for testing, Workspaces can be used to set up testing/staging environments. Each Workspace is assigned its own set of API keys and are completely separate from your other Workspaces. Once you’re ready to migrate a Campaign or message from test to production, you can copy entire workflow actions from one Campaign to another across Workspaces.