Update lead

Updates an existing lead. Only the fields you provide in the request body are changed.

Endpoint

PUT /user/leads/{id}

Path parameters

integer

required

ID of the lead to update.

Request

integer

ID of the campaign to assign the lead to. Must belong to your account.

string

New phone number for the lead. Automatically formatted to E.164.

string

New status. Allowed values: created, completed, reached-max-retries.

Only a subset of statuses can be set manually. Statuses like processing and scheduled are assigned automatically by the system.

object

Variables to merge with existing lead variables. Existing keys are updated; new keys are added.

Response

string

Confirmation that the lead was updated.

Example

curl -X PUT "https://portal.intellixent.ai/api/user/leads/123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+1234567890",
    "variables": {
      "customer_name": "John Doe",
      "company": "Acme Corp"
    }
  }'

const response = await fetch('https://portal.intellixent.ai/api/user/leads/123', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phone_number: '+1234567890',
    variables: {
      customer_name: 'John Doe',
      company: 'Acme Corp'
    }
  })
});

const data = await response.json();
console.log(data.message);

200 Success

{
  "message": "Lead updated successfully"
}

404 Not found

{
  "message": "Lead not found"
}

422 Validation error

{
  "message": "Validation failed",
  "errors": {
    "status": ["This status is assigned automatically and cannot be set manually"]
  }
}

Overview

Assistants

Calls

Campaigns & Leads

Conversations

Messaging

Phone Numbers

Knowledge & Tools

Webhooks

Endpoint

Path parameters

Request

Response

Example

​Endpoint

​Path parameters

​Request

​Response

​Example

Endpoint

Path parameters

Request

Response

Example