Saltar al contenido principal
POST

Borrar contactos en bloque

Scope:contacts:contacts.write
https://api.holded.com/api/v2/contacts/bulk-delete

Elimina permanentemente varios contactos en una sola solicitud. Esta acción no se puede deshacer. Los contactos que no existen se omiten silenciosamente. Si algún ID de contacto pertenece a otra cuenta, la solicitud falla con error 400. Los documentos existentes vinculados a los contactos eliminados conservan el nombre del contacto para su visualización, pero la asociación en tiempo real se elimina.

Cuerpo de la petición

object
contact_ids[]string[]required

Lista de IDs de contactos a eliminar

Petición

python
import requests

url = "https://api.holded.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())

Respuestas

Respuestas exitosas

204Contactos eliminados correctamente

Respuestas de error

400Solicitud incorrectaapplication/json
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
429Límite de solicitudes excedidoapplication/json