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

# DialNexa Batch Call Common Upload Errors

> Fix DialNexa batch call upload errors caused by phone numbers, file formats, size limits, variable headers, or route readiness.

Common DialNexa batch call upload errors usually come from file format, recipient phone number values, dynamic variable mapping, file size, or selected outbound route. Fix the mapped preview and phone-number review before saving or starting a campaign.

> [!WARNING]
>
> If the preview table looks wrong, the campaign will not become wiser after launch.

## DialNexa Batch Call Upload Error Checklist

Use this table before retrying an upload.

![DialNexa Match CSV Columns modal with mapped phone number, defaulted variables, and an unmapped fields warning.](https://mintcdn.com/dialnexa/HOnVBqIHk6o8-0eg/images/documentation/screenshots/batch-csv-mapping-modal.png?fit=max\&auto=format\&n=HOnVBqIHk6o8-0eg\&q=85\&s=d65e96ff87d2f7bc9a6eeefc6272dd86)

| Problem | What to fix |
| - | - |
| No phone number column | Add a clear phone number column or choose the correct column in **Match CSV Columns**. |
| Unsupported file type | Upload a CSV or supported spreadsheet file. |
| File too large | Files are limited to 10 MB. Reduce the file size or split the campaign. |
| Variable header mismatch | Use **Match CSV Columns** to map your headers to the selected agent version variables. |
| Empty required values | Fill required recipient numbers and important variables. |
| Duplicate phone numbers | Leave **Skip duplicate phone numbers** on for one call per number, or remove the file and turn it off before upload when repeated calls are intentional. |
| More values than header columns | Quote values that contain commas or add a missing header in row `1`. The upload reports the affected physical rows. |
| Invalid JSON-shaped value | Correct the listed row. DialNexa may rejoin split columns, but it asks for review when the result is not valid JSON. |
| Excel data below a blank header | Add a header for that column. Values in unnamed Excel columns are skipped and reported. |
| No selected outbound number | Select the agent, its version, and a From number before downloading or uploading the template. |
| Unsupported country or prefix | Enable the destination route in **Workspace Settings > Telephony**, or change the recipient number. |
| Row-level validation failures | Use **Review Invalid Phone Numbers** to edit or remove failed rows, or download the CSV from that review step for offline cleanup. |

## Destination Validation Errors

Recipient numbers are checked against the same [route rules](https://dialnexa.com/docs/calls/phone-numbers.md#outbound-destination-validation) used by single outbound calls.

| Error type | What to fix |
| - | - |
| Invalid phone number | Add the country code, remove extra characters, or correct the digit count. |
| Unsupported destination country | Enable the destination country in **Workspace Settings > Telephony**, or use a route that supports it. |
| Unsupported prefix | Check whether the number matches the most specific enabled network group prefix for that destination country. |
| No enabled countries configured | Enable at least one network group for the selected provider before uploading the file. |

The upload wizard now shows invalid phone numbers before the recipient table is accepted. Each row shows the source row number, phone number, validation reason, and current decision. Correct the number when the intended recipient is clear. Remove the row when the number is incomplete, belongs to an unsupported destination, or needs offline confirmation.

Rows left unresolved are removed by default before the reviewed file is accepted. Use **Download CSV** from the review step when the upload owner needs a cleanup file with the latest edit and remove decisions.

For direct API uploads, the create request still returns `400 Bad Request` when validation fails. The response groups failed rows by reason so API clients can repair the source file before retrying.

## Clean A Failed Upload

**1. Download the template again**

Use the template for the currently selected agent and version.

**2. Copy data into the template**

Keep headers unchanged while moving rows over, or map your existing headers in the upload modal.

**3. Remove formatting clutter**

Avoid merged cells, hidden formulas, and non-CSV spreadsheet features.

**4. Upload a small sample first**

Test the first few rows before uploading the full list.

**5. Check the preview**

Confirm phone numbers and variables appear in the expected columns.

## File Problems That Look Like Product Bugs

> [accordion] Headers differ by one character
>
> The agent expects the exact variable key after mapping. Use the modal to map readable headers to agent variable keys.

> [accordion] Phone numbers include country twice
>
> Check whether your file already includes country code before entering local digits.

> [accordion] Many rows show the same validation error
>
> The dashboard groups destination validation failures by message and row number. Use **Download CSV** in the phone-number review step when the list needs offline cleanup.

> [accordion] Duplicate numbers disappeared after upload
>
> The create page skips duplicate phone numbers by default and keeps the first row for each non-empty number. Remove the uploaded file and turn off **Skip duplicate phone numbers** before uploading again if repeated calls are intentional.

> [accordion] Values contain commas
>
> Wrap the whole value in double quotes and double any quote inside it. DialNexa can repair some unquoted JSON rows, but malformed rows stop the upload rather than silently shifting values into the wrong variables.

> [accordion] The reported row number looks different from the recipient index
>
> Row notices use the physical spreadsheet line where the record starts. A quoted multiline value can occupy several physical lines while remaining one recipient record.

> [accordion] The selected agent changed
>
> Template variables depend on the selected published agent version.

## Related Reading

> [card] [Recipient Files](https://dialnexa.com/docs/batch-calls/recipient-files.md)
>
> Prepare a clean CSV.

> [card] [Dynamic Variables](https://dialnexa.com/docs/agents/dynamic-variables.md)
>
> Match headers to placeholders.

> [card] [Recipient Results](https://dialnexa.com/docs/batch-calls/recipient-results.md)
>
> Review uploaded rows and outcomes.


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