Delete Record - AI CSR API

curl -X DELETE "https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records?campaignId=YOUR_CAMPAIGN_ID&externalId=CRM_12345" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records?campaignId=YOUR_CAMPAIGN_ID&externalId=CRM_12345',
  {
    method: 'DELETE',
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);

const data = await response.json();

import requests

response = requests.delete(
    'https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records',
    params={
        'campaignId': 'YOUR_CAMPAIGN_ID',
        'externalId': 'CRM_12345'
    },
    headers={'x-api-key': 'YOUR_API_KEY'}
)

print(response.json())

{
  "success": true,
  "data": {
    "deleted": true
  },
  "error": null
}

{
  "success": false,
  "data": null,
  "error": "Lead not found"
}

DELETE

api

records

curl -X DELETE "https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records?campaignId=YOUR_CAMPAIGN_ID&externalId=CRM_12345" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records?campaignId=YOUR_CAMPAIGN_ID&externalId=CRM_12345',
  {
    method: 'DELETE',
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);

const data = await response.json();

import requests

response = requests.delete(
    'https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records',
    params={
        'campaignId': 'YOUR_CAMPAIGN_ID',
        'externalId': 'CRM_12345'
    },
    headers={'x-api-key': 'YOUR_API_KEY'}
)

print(response.json())

{
  "success": true,
  "data": {
    "deleted": true
  },
  "error": null
}

{
  "success": false,
  "data": null,
  "error": "Lead not found"
}

Endpoint Alias: This endpoint is an alias for /api/v1/leads. Both endpoints are functionally identical - use whichever naming convention fits your integration.

Record Lookup

Records are identified by externalId or phoneNumber, not internal IDs.

At least one of phoneNumber or externalId is required. If both are provided, externalId takes priority for the lookup.

Authentication

string

required

Your API key with write scope

Query Parameters

string

required

The ID of the campaign the record belongs to

string

Phone number in E.164 format.Required if externalId is not provided.

string

Your CRM’s internal ID for this record.Required if phoneNumber is not provided.

Response

boolean

Whether the request was successful

object

Show properties

boolean

Always true if the request succeeded

string | null

Error message if request failed

Examples

curl -X DELETE "https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records?campaignId=YOUR_CAMPAIGN_ID&externalId=CRM_12345" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records?campaignId=YOUR_CAMPAIGN_ID&externalId=CRM_12345',
  {
    method: 'DELETE',
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);

const data = await response.json();

import requests

response = requests.delete(
    'https://YOUR_DEPLOYMENT.lupitor.com/api/v1/records',
    params={
        'campaignId': 'YOUR_CAMPAIGN_ID',
        'externalId': 'CRM_12345'
    },
    headers={'x-api-key': 'YOUR_API_KEY'}
)

print(response.json())

{
  "success": true,
  "data": {
    "deleted": true
  },
  "error": null
}

{
  "success": false,
  "data": null,
  "error": "Lead not found"
}

Notes

Permanent Deletion: This action cannot be undone. The record will be permanently deleted.

Need the record data? Fetch the record first, then delete it.

For full documentation, see Delete Lead.

​Record Lookup

​Authentication

​Query Parameters

​Response

​Examples

​Notes

Record Lookup

Authentication

Query Parameters

Response

Examples

Notes