Removing contacts from a project list via API is a quick and efficient solution, eliminating the need for manual deletions or list uploads. By automating contact removal, you ensure your Brightcall AI Agent or Dialer app is always working with the most relevant and up-to-date contact lists. This reduces manual effort, minimizes errors, and helps maintain clean, optimized project lists for better campaign performance.
Follow this guide to learn how to automate the removal of contacts using the API.
How to set up ?
Get the API key here: https://app.brightcall.ai/pages/general-settings
For all requests API key should be included as an
api-keyquery parameter. E.g.: https://api.dialer.brightcall.ai/api/v2/projects?api-key=%your-api-key%Get a list of all projects through this endpoint: https://api.dialer.brightcall.ai/api/v2/projects Please note, that the Power Dialer project has a
typeparameter equal to 2. Alternatively, you can get one project through this endpoint: https://api.dialer.brightcall.ai/api/v2/project/{project_id}Get the project ID from the
idproperty from the project payload
Get project columns through this endpoint: https://api.dialer.brightcall.ai/api/v1/project-columns/{project_id}
Get project contacts through this endpoint: https://api.dialer.brightcall.ai/api/v1/project-contacts/{project_id}
Find the
idof each contact you want to remove. The contact’s details are stored in thedatafield. Each entry contains two values: the column ID and the value in that column. For example,[102, "447700900123"]means that column102contains the phone number447700900123.Send a
DELETErequest to this endpoint: https://api.dialer.brightcall.ai/api/v1/project-contacts/{project_id} Body:
{"contactIds": [123456, 123457]}Replace 123456 and 123457 with the contact IDs obtained in step 7. Send the body as JSON with the Content-Type: application/json header.