> For the complete documentation index, see [llms.txt](https://docs.bird.com/connectivity-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bird.com/connectivity-platform/managing-inbox-admins-and-agents/import-agents-to-inbox-using-csv.md).

# Import agents to Inbox using CSV

*(This feature is currently in beta. Please contact customer support to get access to the feature).*

In this article, you will learn how to import users to Inbox using a CSV file. 

## Import users

Please follow these steps to successfully import users to Inbox: 

1. Download the sample CSV file. 
2. Add data to the file. 
3. Upload CSV to Inbox.

### Download the sample CSV file

Please download [this](https://inbox-static.messagebird.com/manager/assets/example.csv) CSV file to get a headstart. Alternatively, you can create your own CSV file with the following mandatory headers:

1. firstName
2. lastName
3. nickName
4. role
5. email
6. languages
7. skills
8. platforms

### Add data to the file

Once you have the CSV file ready, please fill it with the user data. The table below shows an overview of data:

| **Header** | **Description**                      | **Required** | **Example**            |
| ---------- | ------------------------------------ | ------------ | ---------------------- |
| firstName  | User’s first name.                   | Yes          | Jane                   |
| lastName   | Users’ last name.                    | Yes          | Doe                    |
| nickName   | User’s nickname for Inbox.           | No           | Jane                   |
| role       | User’s role in Inbox. Agent of Admin | Yes          | agent                  |
| email      | User’s email address.                | Yes          | <jane.doe@example.com> |
| languages  | Languages assigned to the user.      | No           | en:10                  |
| skills     | Skills assigned to the user.         | No           | support                |
| platforms  | Platforms assigned to the user.      | No           | whatsapp:10            |

Please review the following sections to learn more about assigning languages, skills, and platforms:

1. [Assigning languages to users](#h_01FVJ08C2QRZE0GTWR31DKQHV5)
2. [Assigning skills to users](#h_01FVJ08PASBM5NKNJWFKHH20TB)
3. [Assigning platforms to users](#h_01FVJ090218CQY2AG85BS1P2ME)

### Upload CSV file to Inbox

When your CSV file is ready, head to the Inbox and upload the CSV file by following these steps:

1. Head to Agents page in Inbox.
2. Click on Import Agents.
3. Upload the file.

<figure><img src="/files/HMmdFzpYhFKRJpAcEkys" alt=""><figcaption></figcaption></figure>

Once the file is validated, the import process will start. You can close the modal after the upload. We will notify you by email once the process is complete.&#x20;

## Additional resources

### Assigning languages to users <a href="#h_01fvj08c2qrze0gtwr31dkqhv5" id="h_01fvj08c2qrze0gtwr31dkqhv5"></a>

The format to add a language to a CSV row is **language\_locale:level.**&#x20;

* language\_locale is the language code. For example en for English. You can find a full list [here](https://www.localeplanet.com/icu/).
* the level is the language level for the user. Choose a value from 1 to 10.

To assign multiple languages, separate values with a semicolon (;).&#x20;

#### Examples

* en:10
* el:5
* en:10;nl:5

### Assigning skills to users <a href="#h_01fvj08pasbm5nknjwfkhh20tb" id="h_01fvj08pasbm5nknjwfkhh20tb"></a>

The format to add skills is **skill\_name\_in\_inbox.**

* skill\_name\_in\_inbox is the exact value of skills you create in Inbox.&#x20;

To assign multiple skills, separate values with a semicolon (;).&#x20;

#### Examples

* support
* finance
* support;finance

### Assigning platforms to users <a href="#h_01fvj090218cqy2ag85bs1p2me" id="h_01fvj090218cqy2ag85bs1p2me"></a>

The format to add a language to a CSV row is **platform\_code:level.**&#x20;

* platform\_code is MessageBird’s code for a platform. For example whatsapp. You can find a full list below.
* the level is the language level for the user. Choose a value from 1 to 10.

To assign multiple platforms, separate values with a semicolon (;).&#x20;

#### Examples

* email:10
* instagram:5
* whatsapp:10;email:5

#### Platform Codes

| SMS                        |
| -------------------------- |
| WHATSAPP                   |
| FACEBOOK                   |
| TWITTER                    |
| LINE                       |
| EMAIL                      |
| EMAIL\_FREEMIUM            |
| TELEGRAM                   |
| WECHAT                     |
| WHATSAPP\_SANDBOX          |
| LIVECHAT                   |
| VIBER                      |
| GOOGLE\_BUSINESS\_MESSAGES |
| INSTAGRAM                  |

&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bird.com/connectivity-platform/managing-inbox-admins-and-agents/import-agents-to-inbox-using-csv.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.