DocumentaciónReferencia APICrear lead
    POSTDisponible

    Crear lead

    Operación autenticada de la API de BeepCall.

    https://app.beepcall.ai/api/user/lead

    Parámetros

    Authorization*headerBearer tokenClave de API de BeepCall.
    phone_number*bodystringNúmero principal del lead.
    campaign_id*bodyintegerID de la campaña.
    variablesbodyobjectVariables personalizadas del lead.
    allow_dupplicatebodybooleanPermite crear un contacto duplicado.
    secondary_contactsbodyarrayContactos secundarios del lead.

    * Obligatorio

    Ejemplo de solicitud

    curl -X POST "https://app.beepcall.ai/api/user/lead" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "phone_number": "+1234567890",
  "campaign_id": 456,
  "variables": {
    "customer_name": "Jane Smith",
    "email": "jane@example.com"
  },
  "allow_dupplicate": false,
  "secondary_contacts": [
    {
      "phone_number": "+1987654321",
      "variables": {
        "customer_name": "John Smith"
      }
    }
  ]
}'

    Respuesta

    json
    {
  "message": "Lead created successfully",
  "data": {
    "id": 1,
    "campaign_id": 1,
    "phone_number": "+1234567890",
    "variables": {
      "customer_name": "John Doe",
      "email": "john.doe@example.com"
    },
    "status": "created",
    "created_at": "2025-06-30 11:53:20",
    "updated_at": "2025-06-30 11:53:20",
    "campaign": {
      "id": 1,
      "name": "My new campaign"
    },
    "secondary_contacts": [
      {
        "id": 2,
        "phone_number": "+1234567891",
        "variables": {
          "customer_name": "Jane Doe Secondary",
          "email": "jane.doe.secondary@example.com"
        },
        "status": "created",
        "created_at": "2025-06-30 11:53:20",
        "updated_at": "2025-06-30 11:53:20"
      },
      {
        "id": 3,
        "phone_number": "+1234567892",
        "variables": {
          "customer_name": "Bob Doe Office",
          "email": "bob.doe.office@example.com"
        },
        "status": "created",
        "created_at": "2025-06-30 11:53:20",
        "updated_at": "2025-06-30 11:53:20"
      }
    ]
  }
}

    Errores habituales