DELETE
/
api
/
v1
/
leads
/
{leadId}
Delete Lead
curl --request DELETE \
  --url https://app.journeybee.io/api/v1/leads/{leadId} \
  --header 'Authorization: Bearer <token>'

​
Authentication

curl -X DELETE "https://app.journeybee.io/api/v1/leads/{leadId}" \
  -H "Authorization: Bearer your-api-key-uuid" \
  -H "Content-Type: application/json"

​
Path Parameters

​
leadId
number
required
The unique identifier of the lead to delete

​
Response Schema

The API returns a 204 No Content status code on successful deletion with no response body.

​
Example Request

curl -X DELETE "https://app.journeybee.io/api/v1/leads/789" \
  -H "Authorization: Bearer jb_api_1234567890abcdef" \
  -H "Content-Type: application/json"

​
Example Response

json 204 No Content (No response body)

​
Error Responses

{
  "error": "Invalid API key or insufficient permissions"
}

{
  "error": "Write access required for this operation"
}

{
  "error": "Lead not found or already deleted"
}