Skip to main content
Skip table of contents

How can I Create and Import New Users?

In the same veins of great people making great companies, great platforms need great users too.

Every platform user has a role that controls their access and permission levels. While different roles allow different levels of access to your environments, applications, and projects, you can always manage how your users can interact within your platform. After all, how a user feels when interacting with a system or platform, can make it or break it for you. Adding your preferred set of users to the platform might be the best decision to take, considering we’re already here to make it easy for you.

The Zeta Marketing Platform facilitates the import of users via real-time APIs and SFTP imports. Adding to this, the platform also allows the manual import of individual or bulk users within the user interface (UI) via a CSV document upload. Let’s have a quick look at how easy that can be:

Add your People

1. From the menu on the left, select Audiences > People. Click on New People.

2. Choose the option of your preference from the two that appear.

Option One: Add Users Manually

1. Hover over the Add Users Manually option and click on Continue.

  • Fill in the details for the users being added in the respective text boxes for First Name, Last Name, and Email Address.

  • User ID is the key or the unique identifier for each user in the audiences library. (User ID is generally the email address, but can vary depending on user-specific business requirements)

2. Once you’ve filled in the details for the user(s), click on Add People.

As you have imported the user(s), you can further add more user properties and move on to How to Create a Segment

This method of importing users is not recommended for production use, owing to its manual nature. This is a good process for users to get familiar with the platform.

Option Two: Import From CSV File

This option is useful for adding users in bulk and setting up your initial audience or practicing further segmentation with fake data.

1. Hover over the Import from CSV File option and click on Continue. Browse the desired CSV file from your computer library.

Recommended: The CSV file you upload must have the following list of fields:



user_id (required)

This is a unique value used to identify individual users and is usually an email address. If another value is provided as the user_id, the email field is mandatory to be filled up.

email (recommended if user_id is not email)

Must be included in order for the user to receive emails from the ZMP. Will serve as user_id if user_id is not provided.


This is treated as the first name of the user record and can be used to personalize messages.


This is treated as the last name of the user record and can be used to personalize messages.


This field shows the city of the user, for instance, New York.


This is treated as the date when the user signed up with your business. We recommend YYYY-MM-DD hh:mm:ss format.

The user_id column is the only mandatory column. However, it is a good practice to add as much user data/properties as possible. 

2. Once you import the CSV file, ZetaHub will verify the user data by mapping the respective columns into the system. You can do it manually or let the system take care of it.

  • All new properties (columns in the CSV) will be added to the user profile.

  • Any property that already exists will be updated with the new values.

3. All the users whose details are provided in the CSV file, will be imported to the platform.

Once you’ve imported the users, you will re-land on the user library page with options available to update existing users and optionally create a segment from the import. Let's move on to see how! 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.