> ## Documentation Index
> Fetch the complete documentation index at: https://docs.outkept.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importing your data

> Pick how your user data reaches the platform.

For simulations to work, emails must reach the intended recipients. To make that possible we
generate anonymised tags and placeholders from the information your organisation provides.

<Info>
  Our ethical phishing community does not know which companies receive their simulations,
  and they never collect or access the data resulting from them.
</Info>

## Pick how you import

<CardGroup cols={2}>
  <Card title="CSV" icon="file-csv" href="/import-csv">
    Upload a file. Quickest to set up.
  </Card>

  <Card title="Microsoft Entra ID" icon="microsoft" href="/import-active-directory">
    We pull from your directory daily.
  </Card>

  <Card title="Google Workspace" icon="google" href="/import-google-workspace">
    Syncs automatically.
  </Card>

  <Card title="SCIM" icon="arrows-rotate" href="/import-scim">
    Your identity provider pushes users to us.
  </Card>
</CardGroup>

## Which one do I need

| Your situation | Do this |
| - | - |
| A short campaign, or a one-off list | [CSV](/import-csv) |
| You use Microsoft and a daily refresh is fine | [Microsoft Entra ID](/import-active-directory) |
| You use Google Workspace | [Google Workspace](/import-google-workspace) |
| Your workforce changes often and you want changes to land within the hour | [SCIM](/import-scim) |
| Your IT team wants a zero-maintenance flow, with joiners and leavers handled by group membership | [SCIM](/import-scim) |
| You are on Microsoft Entra ID Free | [Microsoft Entra ID](/import-active-directory). SCIM to a non-gallery app needs Entra ID P1 or higher |

<Tip>
  CSV is easier for short campaigns. For six months or longer, use a sync so joiners and
  leavers are handled without anyone re-importing.
</Tip>

## Required and optional data

| Field | Status |
| - | - |
| Email address | Required |
| Country | Required |
| Language | Required |
| Firstname | Optional |
| Lastname | Optional |
| Department | Optional |
| Seniority | Optional |
| Organisation | Optional |
| Industry | Optional |
| Function title | Optional |
| Gender | Optional |

Country and Language are the only tags that are mandatory for launching a campaign.
Everything else improves relevance.

Adding the optional fields improves targeting and personalisation on the phisher side. For
example, Firstname becomes a placeholder in the email, and Function title becomes a
targeting tag.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.