Bulk delete contacts
Scope: contacts:contacts.write https://api.alladdin.com/api/v2/contacts/bulk-delete
Permanently deletes multiple contacts in a single request. This action cannot be undone.
Contacts that do not exist are silently skipped. If any contact ID belongs to a different account the request fails with 400. Existing documents linked to deleted contacts retain the contact name for display, but the live association is removed.
Request body
object contact_ids[] string[] required
List of contact IDs to delete (24-char hex ObjectId each)
Request
import requests
url = "https://api.alladdin.com/api/v2/contacts/bulk-delete"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"contact_ids": [
"string"
]
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())Responses
Success responses
204 Resource deleted
Error responses
400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 429 Rate limit exceeded application/json