> For the complete documentation index, see [llms.txt](https://docs.stoik.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stoik.io/human-security/phishing/manual-import.md).

# Manual employee import

If your organization does not use Google Workspace or Microsoft 365, import your employees from a CSV file.

## Prerequisites

* Manual import is enabled for your account. It is not self-service: email <protect@stoik.io> with the exact name of your email solution and whether it is on-premise or SaaS. Our team reviews the request.

{% hint style="info" %}
A manual provider shows the status **Active (degraded)**. This is expected: campaigns work, but there is no live directory sync. Employees are not added or removed automatically, so you keep the list up to date yourself.
{% endhint %}

## Import your employees

{% stepper %}
{% step %}

### Add a Manual import provider

1. Go to `Overview` > `Settings`.
2. In the providers table, click **Add a provider**.
3. Select **Manual import**. If you don't see it, contact your Stoïk Customer Success Manager.

<figure><img src="https://2582414397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2Fnp29ku0xybr6fLbfsq0B%2FScreenshot%202026-07-16%20at%2011.09.10.png?alt=media&amp;token=107a8ef2-dd2c-436b-a784-db7221886441" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Download the CSV template

In the pop-in, click **Download the CSV template**.

<figure><img src="https://2582414397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2FOu99yt8XFSdvlbSgNhJZ%2FScreenshot%202026-07-16%20at%2011.09.17.png?alt=media&amp;token=3f979d7b-25af-4672-a42d-14fe290fe6b4" alt=""><figcaption></figcaption></figure>

| Column        | Required | Description                                                                    |
| ------------- | -------- | ------------------------------------------------------------------------------ |
| `email`       | Yes      | Employee email address                                                         |
| `firstName`   | Yes      | Employee first name                                                            |
| `lastName`    | Yes      | Employee last name                                                             |
| `language`    | Yes      | Language code: `fr`, `en`, `de`, `es`, `nl`                                    |
| `timezone`    | No       | IANA timezone (e.g. `Europe/Paris`). Defaults to `Europe/Paris` if left empty. |
| {% endstep %} |          |                                                                                |

{% step %}

### Fill in and upload the file

1. Fill in one row per employee and save the file as `.csv`.
2. In the pop-in, click **Upload** and select your file.
3. Fix any highlighted row (missing required field, invalid email format, unsupported language code) and upload again.
4. Once all rows are valid, click **Confirm**.

A **Manual** provider appears in your providers table with the status **Active (degraded)**. Your employees can now be included in campaigns.

<figure><img src="https://2582414397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2Fe9W6hJRcwQDMkubyMrgV%2FScreenshot%202026-07-16%20at%2011.09.45.png?alt=media&amp;token=24d57de4-e69f-4deb-a8eb-74245d710694" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Update the employee list

1. In `Overview` > `Settings`, find the **Manual** row in the providers table.
2. Click `...` > **Edit employee list**.
3. Upload an updated CSV or adjust individual employees.

<figure><img src="https://2582414397-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDGGQ49Oui29Ft0kJjSm%2Fuploads%2F1nlnLEjXBBwHyHIjsLQ8%2FScreenshot%202026-07-16%20at%2011.09.56.png?alt=media&amp;token=1d2e951c-ec6d-46a7-9942-6cb2faa3d23e" alt=""><figcaption></figcaption></figure>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stoik.io/human-security/phishing/manual-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.