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

# Import Contacts

> Bulk import contacts from a CSV or Excel file

## Request

```bash theme={null}
curl -X POST https://app.orova.ai/api/contacts/upload \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@contacts.csv" \
  -F "workspaceId=WORKSPACE_ID"
```

## Parameters

| Field         | Type   | Required | Description       |
| ------------- | ------ | -------- | ----------------- |
| `file`        | file   | Yes      | CSV or Excel file |
| `workspaceId` | string | Yes      | Workspace ID      |

## File format

CSV with headers:

```csv theme={null}
contactName,phoneNumber,region,accountNumber
John Doe,+1234567890,US East,ACC-001
```

Required columns: `contactName`, `phoneNumber`. All other columns are stored as external fields.

## Response

```json theme={null}
{
  "imported": 150,
  "skipped": 2,
  "errors": []
}
```