Skip to main content
POST
cURL
Límite de Tasa: 12 solicitudes por segundo
Hasta 1000 contactos por solicitud. Cada item se procesa de forma independiente, así que una fila inválida no rompe el lote. La respuesta incluye un summary agregado y results por item.
Envía un header Idempotency-Key (UUID recomendado) para que los reintentos no encolen lotes duplicados.

Manejo de Duplicados

if_duplicate controla el comportamiento cuando el número del contacto ya existe en la campaña:
  • skip (por defecto): mantener el contacto existente, devolver skipped_duplicate.
  • update: sobreescribir name, context, extracted_data y f_id en el contacto existente, devolver updated.

Estados por item

Ejemplos

Ejemplo de Respuesta

Autorizaciones

Authorization
string
header
requerido

Add api-key YOUR_API_SECRET_KEY as the value of the Authorization header.

Encabezados

Idempotency-Key
string

Optional client-generated key (UUID recommended) to make the request idempotent.

Parámetros de ruta

id
integer
requerido

The identifier of the Campaign

Cuerpo

application/json

Batch of contacts to create

contacts
object[]
requerido
Required array length: 1 - 1000 elements
if_duplicate
enum<string>
predeterminado:skip

Behavior when the contact's phone number already exists in this campaign.

Opciones disponibles:
skip,
update

Respuesta

Batch processed

success
boolean
summary
object
results
object[]