Registrar un prospecto

API de Wizerp › Registrar un prospecto

Prospectos

# Registrar un prospecto

POST https://api.wizerp.com/api/v1/leads

Crea una ficha de prospecto en el CRM. Necesita nombre o empresa, y correo o teléfono. Los datos van en el cuerpo JSON, nunca en la URL.

Manda la cabecera Idempotency-Key para poder reintentar sin duplicar: con la misma clave y los mismos datos se devuelve la respuesta guardada, byte por byte.

Permiso: leads:write

## Cuerpo JSON
- `nombre` (texto): Máximo 100. Se necesita éste o «empresa».
- `empresa` (texto): Máximo 200.
- `correo` (texto): Máximo 50. Se necesita éste o «telefono».
- `telefono` (texto): Máximo 30.
- `mensaje` (texto): Máximo 2000.
- `vendedor` (entero): Clave del vendedor al que se asigna.

POST https://api.wizerp.com/api/v1/leads

https://api.wizerp.com/api/v1/leads

Crea una ficha de prospecto en el CRM. Necesita nombre o empresa, y correo o teléfono. Los datos van en el cuerpo JSON, nunca en la URL.

Manda la cabecera Idempotency-Key para poder reintentar sin duplicar: con la misma clave y los mismos datos se devuelve la respuesta guardada, byte por byte.

Requiere el permiso leads:write en la llave · contrato del 2026-10-09

Cuerpo JSON

nombre texto

Máximo 100. Se necesita éste o «empresa».

empresa texto

Máximo 200.

correo texto

Máximo 50. Se necesita éste o «telefono».

telefono texto

Máximo 30.

mensaje texto

Máximo 2000.

vendedor entero

Clave del vendedor al que se asigna.

Respuestas

400 Petición mal formada: filtro no permitido, filtro vacío, cursor o límite inválidos, o una cabecera de navegador

401 La llave no es válida, está revocada, venció, o la empresa dejó de ser PRO

403 La llave no tiene el permiso que pide esta operación

404 La ruta no existe, o tu empresa no tiene la API habilitada

409 Misma Idempotency-Key con datos distintos

413 El cuerpo pasa del máximo

422 Un dato no es válido para tu empresa

429 Pasaste un tope. La respuesta trae Retry-After

500 Falló de nuestro lado. Reintenta y reporta el valor de peticion

503 Tu empresa tiene demasiadas peticiones en curso, o la búsqueda no está disponible. Trae Retry-After

Lenguaje

Petición · cURL

curl -X POST https://api.wizerp.com/api/v1/leads \
  -H "Authorization: Bearer wzk_live_…" \
  -H "X-Wizerp-Key-Id: 208_a3f91c7d" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"María Fernanda Olvera","correo":"mf.olvera@ejemplo.com.mx"}'

$ch = curl_init('https://api.wizerp.com/api/v1/leads');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer wzk_live_…',
    'X-Wizerp-Key-Id: 208_a3f91c7d',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS,
    '{"nombre":"María Fernanda Olvera","correo":"mf.olvera@ejemplo.com.mx"}');
$r = json_decode(curl_exec($ch), true);

const r = await fetch(
  "https://api.wizerp.com/api/v1/leads",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer wzk_live_…",
      "X-Wizerp-Key-Id": "208_a3f91c7d",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"nombre":"María Fernanda Olvera","correo":"mf.olvera@ejemplo.com.mx"}),
  }
);
const datos = await r.json();

import requests

r = requests.post(
    "https://api.wizerp.com/api/v1/leads",
    headers={
        "Authorization": "Bearer wzk_live_…",
        "X-Wizerp-Key-Id": "208_a3f91c7d",
    },
    json={"nombre":"María Fernanda Olvera","correo":"mf.olvera@ejemplo.com.mx"},
)
datos = r.json()

Respuesta elige un ejemplo

{
    "ok": true,
    "prospecto": 184027,
    "creado": true,
    "folio": "texto"
}

{
    "ok": false,
    "error": {
        "codigo": "json_invalido",
        "mensaje": "Petición mal formada: filtro no permitido, filtro vacío, cursor o límite inválidos, o una cabecera de navegador",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

{
    "ok": false,
    "error": {
        "codigo": "llave_invalida",
        "mensaje": "La llave no es válida, está revocada, venció, o la empresa dejó de ser PRO",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

{
    "ok": false,
    "error": {
        "codigo": "limite_excedido",
        "mensaje": "Pasaste un tope. La respuesta trae Retry-After",
        "peticion": "req_dca2d22e3324f9a8"
    }
}

Ver la referencia completa