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"
}
Records
Delete Record
Delete a single record from your campaign
DELETE
/
api
/
v1
/
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 byexternalId 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 scopeQuery 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
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.