Delete a contact
Scope: contacts:contacts.write https://api.alladdin.com/api/v2/contacts/{contactId}
Permanently deletes a contact from your account. This action cannot be undone.
Existing documents (invoices, estimates, etc.) linked to this contact will retain the contact name for display purposes, but the live association is removed. You will not be able to filter documents by this contact after deletion.
Parameters
Path parameters
contactId string required
Contact ID (24-char hex ObjectId)
Request
import requests
url = "https://api.alladdin.com/api/v2/contacts/{contactId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.delete(url, headers=headers)
print(response.json())Responses
Success responses
204 Resource deleted
Error responses
401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Contact not found application/json 429 Rate limit exceeded application/json