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

# Contacts

> Import, organize, and manage the contacts your Wave Runner agents will call.

Contacts stores every person your agents call.

Each contact belongs to a list. Lists are what you select when creating a campaign. Organize contacts by audience, client, or use case.

## Contact statuses

Every contact has one of three statuses that controls whether the agent will call them.

<CardGroup cols={3}>
  <Card title="Active" icon="circle-check">
    The contact can be included in campaigns. Default status for new contacts.
  </Card>

  <Card title="Inactive" icon="circle-pause">
    Excluded from campaign dialing but remains in your contacts.
  </Card>

  <Card title="Do not call" icon="ban">
    Wave Runner never dials a do-not-call contact, even if they appear in a campaign's contact list.
  </Card>
</CardGroup>

<Warning>
  Do-not-call is enforced automatically. If a contact asks not to be called during a call, Wave Runner marks them do-not-call immediately. This cannot be overridden at the campaign level.
</Warning>

## Create a contact list

<Steps>
  <Step title="Open Contacts">
    Go to **Contacts** in the navbar.
  </Step>

  <Step title="Add a new list">
    Click **+ New List** in the filter bar at the top of the page.
  </Step>

  <Step title="Name the list">
    Enter a name and confirm. The list appears as a filter chip and is available immediately when creating a campaign.
  </Step>
</Steps>

## Add contacts manually

<Steps>
  <Step title="Select a list">
    Click the list filter chip you want to add the contact to.
  </Step>

  <Step title="Open the add contact dialog">
    Click **Add Contact** in the toolbar.
  </Step>

  <Step title="Fill in the details">
    Enter the contact's first name, last name, phone number, and email. Phone number is required.
  </Step>

  <Step title="Save">
    Click **Add Contact**. The contact appears in the table immediately.
  </Step>
</Steps>

## Import contacts from a CSV

<Tabs>
  <Tab title="Quick upload">
    Click **Upload CSV** in the contacts toolbar and select your file. Wave Runner imports all valid rows and saves the file as a CSV import. Select it as a contact source when creating a campaign.
  </Tab>

  <Tab title="Upload into a list">
    Click **Upload List** to import a CSV and assign all contacts to a specific list at the same time.
  </Tab>
</Tabs>

### CSV format

Your file must have a header row. Recognized column names:

| Column        | Required          | Notes                                                        |
| ------------- | ----------------- | ------------------------------------------------------------ |
| `first_name`  | Yes               | Also accepts: `firstname`, `first`, `fname`                  |
| `last_name`   | No                | Also accepts: `lastname`, `last`, `lname`                    |
| `phone`       | Yes (if no email) | Also accepts: `phone_number`, `telephone`, `mobile`          |
| `email`       | Yes (if no phone) | Also accepts: `email_address`                                |
| `status`      | No                | `active`, `inactive`, or `do-not-call`. Defaults to `active` |
| `do_not_call` | No                | `true` or `1` marks the contact do-not-call on import        |

<Note>
  Wave Runner normalizes phone numbers automatically. Formats like `07911123456`, `+44 7911 123456`, and `4407911123456` all import correctly.
</Note>

## Search and filter contacts

* **Search** — type a name, email, or phone number to filter in real time
* **List filter** — click a list chip to show only contacts in that list
* **Status filter** — filter by active, inactive, or do-not-call
* **Sort** — sort by name, date added, or status

## Contact details

Click any row to open the contact's detail panel. From here you can edit the name, phone, email, list assignment, and status, or delete the contact.

## Bulk delete

Select contacts using the checkboxes in the table, then click **Delete selected** in the toolbar.

<Warning>
  Bulk delete permanently removes the selected contacts. This cannot be undone.
</Warning>

## Launch a campaign from Contacts

When you have a list selected in the filter bar, a **Create Campaign** button appears next to the list chips. Clicking it opens the new campaign dialog with that list pre-selected.

## Delete a CSV import

Hover over a CSV file in the imports section and click the delete option. If the file is being used as the contact source for an active campaign, Wave Runner warns you before proceeding.

## Next steps

<Card title="Create a campaign" icon="megaphone" href="/campaigns/create">
  Run outbound calls against your contact list.
</Card>