Skip to main content
DELETE
Remove a contact from a list
Removes one contact from a saved list. Get the contact’s _id from Get a contact list.
The dialing queue keeps the contact until you refill it with Reimport a contact list into the dialing queue.

Example

Response (200):

Behavior

  • Safe to retry. The call returns 200 whether or not the list holds a contact with that ID, so a 200 does not prove the contact was there.
  • If the same _id appears more than once in the list, as it can after merging the same source list twice, every copy is removed.

Errors

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

id
string
required

ID of the saved list. A value that is not a valid ID fails with 400.

Example:

"6650c1f2a4b8e93d2c1f0a11"

contactId
string
required

The contact's _id in the saved list, from GET /v1/contact-lists/csv/{id}. A value that is not a valid ID fails with 400.

Example:

"6650c1f2a4b8e93d2c1f0a12"

Response

Removed, or the list held no contact with that ID.

success
boolean

Always true.

Example:

true

message
string

Not returned by production; the body is { "success": true }.