---
title: "Dialer contact list file schemas"
slug: "dialer-contact-list-file-schemas"
description: "This article contains descriptions of the data structure schemas supported for Dialer campaign CSV file format calling lists."
updated: 2026-05-22T10:03:26Z
published: 2026-05-22T10:03:26Z
canonical: "docs.voiso.com/dialer-contact-list-file-schemas"
---

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

# Dialer contact list file schemas

**Who should read this article**: Administrators, Supervisors

This article contains descriptions of the data structure schemas supported for Dialer campaign CSV file format calling lists.

## Introduction

Outbound Dialer supports three methods of importing calling lists into an outbound campaign:

- [CSV or XLSX file](/v1/docs/outbound-dialer-adding-a-new-campaign#file-import)
- [CRM integration](/v1/docs/outbound-dialer-adding-a-new-campaign#crm)
- [API](/v1/docs/running-an-api-campaign)

Information

After adding your calling list, Dialer reviews the numbers to ensure their validity and remove any duplicates. Invalid and duplicate numbers are compiled into a downloadable CSV file. Additionally, you can download the final calling list that Dialer will use for the campaign.

## Calling list formats

This section describes the alternative calling lists formats that you may request from your Voiso representative, premium support channel, or by email at support@voiso.com.

### Only Numbers

The **Only Numbers** schema specifies a list containing only phone numbers. The file should have a single column of phone numbers formatted in E.164.

Example:

| Number |
| --- |
| 85291234567 |
| 918765432109 |
| 628123456789 |

### Numbers With URL

The **Numbers With URL** schema pairs phone numbers with associated URLs for screen pop. The file consists of two columns: phone numbers in E.164 format in the first column and fully qualified URLs in the second column.

Example:

| Number | URL |
| --- | --- |
| 441234567890 | https://example-business-uk.com/contact |
| 4915123456789 | https://example-germany-shop.de/signup |
| 33123456789 | https://example-restaurant.fr/reservation |

## Numbers With Name and Source

The **Numbers With Name and Source** schema includes phone numbers along with contact names and source details. It is the default contact list format. The file should have three columns: phone numbers in E.164 format in the first column, contact names in the second column, and source names in the third column.

Example:

| Number | Name | Source |
| --- | --- | --- |
| 441234567890 | Oliver Bennett | EuroBiz Networking Event 2025 |
| 4915123456789 | Mia Fischer | TechConnect Europe Summit |
| 33123456789 | Élise Dubois | GreenFuture Sustainability Email Campaign |

### Numbers With Priority

The **Numbers With Priority** schema is a two column structure with the contact phone number in E.164 format in the first column and a priority value in the second column that represents the calling priority of the contact. Priority ranges from 0 to 1000, where lower values equal higher priority. 0 is the highest priority.

Example:

| Number | Priority |
| --- | --- |
| 5511998765432 | 21 |
| 5491134567890 | 0 |
| 573045678901 | 13 |
| 59891234567 | 13 |

An international standard that specifies the format for phone numbers. In E.164 format, a phone number consists of a country code, a national destination code, and a subscriber number. The E.164 format eliminates additional characters or symbols like parentheses, dashes, or spaces, providing a globally recognized structure for telephone numbers.

Refer to https://www.itu.int/rec/T-REC-E.164