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

# Upload Leads via CSV to Your Campaign

> Add leads to any Vosen campaign by uploading a CSV file, mapping columns, and previewing AI-personalised voice note scripts before you send.

CSV upload is the fastest way to bring an existing lead list into Vosen. You drop in a file, tell Vosen which column maps to which field, and Vosen immediately generates a personalised voice note script for every row — all before a single message is sent.

## CSV format

Your file must include at least the three required columns. Adding the optional columns unlocks richer AI personalisation.

| Column        | Required   | Used for                                                        |
| ------------- | ---------- | --------------------------------------------------------------- |
| First Name    | ✅ Yes      | Personalising the opening of every script                       |
| Last Name     | ✅ Yes      | Matching leads to their LinkedIn profile                        |
| LinkedIn URL  | ✅ Yes      | Identifying where to send the voice note                        |
| Company       | ✗ Optional | Mentioning the lead's employer in the script                    |
| Job Title     | ✗ Optional | Referencing the lead's role in the script                       |
| Custom fields | ✗ Optional | Any extra context you want available for script personalisation |

### Example CSV

```csv theme={null}
First Name,Last Name,LinkedIn URL,Company,Job Title
Sarah,Chen,https://linkedin.com/in/sarahchen,Acme Corp,Head of Growth
James,Patel,https://linkedin.com/in/jamespatel,Brightline,VP of Sales
```

## Uploading your CSV

<Steps>
  <Step title="Open your campaign">
    Navigate to **Campaigns** in the left sidebar and click the campaign you want to add leads to. If you haven't created one yet, click **New campaign** first.
  </Step>

  <Step title="Click &#x22;Add leads&#x22; → &#x22;Upload CSV&#x22;">
    Inside the campaign, click the **Add leads** button and select **Upload CSV** from the dropdown menu.
  </Step>

  <Step title="Select your file">
    Drag your CSV file onto the upload area or click **Browse** to find it on your computer. Vosen accepts `.csv` files up to 10 MB.
  </Step>

  <Step title="Map columns to fields">
    Vosen displays a column-mapping screen. Use the dropdowns to match each column in your file to the correct Vosen field. Columns Vosen can't auto-detect are highlighted for your attention. Click **Confirm mapping** when done.
  </Step>

  <Step title="Preview personalised scripts">
    Vosen generates an AI-written script for every lead using the data you've mapped. Scroll through the previews, edit any script inline, and mark individual leads as approved or skipped.
  </Step>

  <Step title="Confirm and continue">
    Click **Add to campaign** to finalise the import. Your leads are now queued and ready to send when you launch the campaign.
  </Step>
</Steps>

## Script personalisation

Vosen's AI uses the data from your CSV to write a unique, emotion-enhanced script for each lead. Here's how the fields are used:

* **First Name** — Vosen opens the voice note by addressing the lead directly, making it feel like a real conversation starter.
* **Company** — Vosen weaves the lead's employer into the message to show you've done your homework ("I noticed you're at Acme Corp…").
* **Job Title** — Vosen tailors the value proposition to the lead's seniority and function ("As a Head of Growth, you'll appreciate…").

When all three personalisation fields are present, the result is a script that sounds hand-crafted — not templated.

<Tip>
  Always include **Company** and **Job Title** in your CSV. Even one extra field significantly increases the relevance of the generated script and lifts reply rates.
</Tip>

<Warning>
  LinkedIn URLs must be the full profile URL in the format `https://linkedin.com/in/username`. Short URLs, vanity redirects, or Sales Navigator links will cause the lead to fail validation and be excluded from the campaign.
</Warning>