Reimport a contact list into the dialing queue

curl --request POST \
  --url https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport"

headers = {"x-api-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "_id": "6650c1f2a4b8e93d2c1f0a10",
  "name": "Q2 Outbound Prospects",
  "source": "csv",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "user": "680edc0d1504192884a148e0",
  "contacts": [
    {
      "_id": "6650c1f2a4b8e93d2c1f0a12",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "company": "Acme Corp",
      "title": "VP of Sales",
      "phone_numbers": [
        {
          "_id": "6650c1f2a4b8e93d2c1f0a13",
          "type": "direct",
          "number": "+14155552671"
        }
      ],
      "custom_fields": [
        {
          "_id": "6650c1f2a4b8e93d2c1f0a14",
          "type": "string",
          "label": "Account tier",
          "value": "Enterprise"
        }
      ]
    }
  ],
  "createdAt": "2026-10-03T14:05:22.470Z",
  "updatedAt": "2026-10-03T16:05:03.118Z",
  "__v": 0
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "CSV contact list not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Contact lists

Reimport a contact list into the dialing queue

Replaces every contact in a list’s dialing queue with the saved list’s current contacts, exactly as saved. Contacts added to the saved list since the last refill join the queue, and removed ones leave it.

Call it once after a batch of POST /v1/contact-lists/{id}, DELETE /v1/contact-lists/{id}/contacts/{contactId} or POST /v1/contact-lists/{id}/merge calls. Safe to retry: running it again gives the same queue.

The copy adds nothing. Importing the list in the dashboard also marks snooze dates, do-not-call and wrong-number flags, call counts and latest dispositions on the contacts; this call does not, and any such markings already in the queue are discarded. Numbers on the team’s do-not-call list are still blocked when dialed.

Returns the dialing queue’s record with all its contacts. Its _id is the dialing queue’s own ID, not the saved list ID you sent.

POST

contact-lists

csv

{id}

reimport

Reimport a contact list into the dialing queue

curl --request POST \
  --url https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport"

headers = {"x-api-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v1/contact-lists/csv/{id}/reimport")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "_id": "6650c1f2a4b8e93d2c1f0a10",
  "name": "Q2 Outbound Prospects",
  "source": "csv",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "user": "680edc0d1504192884a148e0",
  "contacts": [
    {
      "_id": "6650c1f2a4b8e93d2c1f0a12",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "company": "Acme Corp",
      "title": "VP of Sales",
      "phone_numbers": [
        {
          "_id": "6650c1f2a4b8e93d2c1f0a13",
          "type": "direct",
          "number": "+14155552671"
        }
      ],
      "custom_fields": [
        {
          "_id": "6650c1f2a4b8e93d2c1f0a14",
          "type": "string",
          "label": "Account tier",
          "value": "Enterprise"
        }
      ]
    }
  ],
  "createdAt": "2026-10-03T14:05:22.470Z",
  "updatedAt": "2026-10-03T16:05:03.118Z",
  "__v": 0
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "CSV contact list not found",
  "error": "Not Found",
  "statusCode": 404,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Refills a list’s dialing queue from its saved list. The queue’s contacts are replaced by the saved list’s current contacts, so contacts you added since the last refill join the queue and contacts you removed leave it. Call it once after a batch of changes:

Add a contact to a list, remove a contact from a list or merge contact lists, as many times as you need.
Call this endpoint once, with the saved list’s ID.

Example

curl https://client-api.salesfinity.co/v1/contact-lists/csv/6650c1f2a4b8e93d2c1f0a11/reimport \
  --request POST \
  --header 'x-api-key: YOUR_API_KEY'

Response (201), the dialing queue’s record:

{
  "_id": "6650c1f2a4b8e93d2c1f0a10",
  "name": "Q2 Outbound Prospects",
  "source": "csv",
  "team": "64f1a2b3c4d5e6f7a8b9c0d1",
  "user": "680edc0d1504192884a148e0",
  "contacts": [
    {
      "_id": "6650c1f2a4b8e93d2c1f0a12",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "company": "Acme Corp",
      "title": "VP of Sales",
      "phone_numbers": [
        { "_id": "6650c1f2a4b8e93d2c1f0a13", "type": "direct", "number": "+14155552671" }
      ],
      "custom_fields": [
        { "_id": "6650c1f2a4b8e93d2c1f0a14", "type": "string", "label": "Account tier", "value": "Enterprise" }
      ],
      "email_views": 0,
      "sequence_step": 0
    }
  ],
  "createdAt": "2026-10-03T14:05:22.470Z",
  "updatedAt": "2026-10-03T16:05:03.118Z",
  "__v": 0
}

The _id in the response is the dialing queue’s own ID, not the saved list ID you sent. Keep using the saved list ID with this API.

What the copy does

It copies the saved contacts exactly. When a rep imports the list in the dashboard, Salesfinity also marks snooze dates, do-not-call and wrong-number flags, call counts and latest dispositions on the contacts. This call adds none of them, and discards any already in the queue.
Numbers on your team’s do-not-call list are still blocked when a rep dials them.
Safe to retry: running it again leaves the same queue.
The response contains every contact in the queue, so it grows with the list.

Errors

Status	When
404	No saved list with this ID in your team, or the list has no dialing queue (`CSV contact list not found`).
400	The `id` is not a valid ID (`Invalid ObjectId format for parameter: id`).

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

string

required

ID of the saved list, from POST /v1/contact-lists or GET /v1/contact-lists/csv. A value that is not a valid ID fails with 400.

Example:

"6650c1f2a4b8e93d2c1f0a11"

Response

Refilled. The body is the dialing queue's record.

A list's dialing queue as stored, returned by POST /v1/contact-lists/csv/{id}/reimport. Lists created in the dashboard can carry further internal fields.

_id

string

ID of the dialing queue. It differs from the saved list ID in the path.

Example:

"6650c1f2a4b8e93d2c1f0a10"

name

string

Example:

"Q2 Outbound Prospects"

source

string

csv for every list these endpoints manage.

Example:

"csv"

team

string

ID of your team.

Example:

"64f1a2b3c4d5e6f7a8b9c0d1"

user

string

ID of the member who owns the list.

Example:

"680edc0d1504192884a148e0"

contacts

object[]

Every contact now in the dialing queue, copied from the saved list with the same _id values.

Show child attributes

createdAt

string<date-time>

updatedAt

string<date-time>

__v

integer

Internal document version. Ignore it.

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

Reimport a contact list into the dialing queue

Example

What the copy does

Errors

Authorizations

Path Parameters

Response

​Example

​What the copy does

​Errors

Authorizations

Path Parameters

Response

Example

What the copy does

Errors