Skip to main content
DELETE
/
lead
/
{lead_list_id}
/
Delete Lead List
curl --request DELETE \
  --url https://management.scanova.io/lead/{lead_list_id}/ \
  --header 'Authorization: <api-key>'
This response does not have an example.

​
Overview

Permanently deletes a lead list and all associated data. This action cannot be undone.

​
Path Parameters

ParameterTypeRequiredDescriptionExample
lead_list_idstringYesLead list ID (lead_id)Lecb6be7be43b4724

​
Response

Returns a 204 No Content status on successful deletion.

​
Examples

​
Delete Lead List

curl -X DELETE "https://management.scanova.io/lead/Lecb6be7be43b4724/" \
  -H "Authorization: YOUR_API_KEY"

​
Important Considerations

​
Before Deleting

  • Check Linked QR Codes: Ensure no active QR codes are using this lead list
  • Backup Data: Export any important lead data before deletion
  • Notify Team: Inform team members about the deletion
  • Consider Deactivation: Use the update endpoint to deactivate instead of delete

​
What Gets Deleted

  • Lead list configuration
  • All captured lead entries
  • Webhook configurations
  • Form settings and styling

​
What Remains

  • QR codes that were linked to this lead list (they will have no lead list attached)
  • Historical analytics data (if any)

​
Use Cases

  • Cleanup: Remove unused or test lead lists
  • Data Privacy: Delete lead lists containing sensitive information
  • Account Management: Clean up old lead lists to stay within limits
  • Compliance: Remove lead lists for GDPR or other compliance requirements
Permanent Action: Deleting a lead list is irreversible. All lead data and configurations will be permanently lost. Consider deactivating the lead list instead if you might need it later.
If you need to preserve the lead data, consider exporting it first or simply deactivating the lead list using the update endpoint.

Authorizations

​
Authorization
string
header
required

API key authentication. Enter your API key directly in the Authorization header.

Path Parameters

​
lead_list_id
string
required

Lead list ID (lead_id)

Response

Lead list deleted successfully