Delete a lead

DELETE https://api.tamio.com/v2/leads/{uuid}

Permanently deletes a lead and all associated data including contact information, status history, and address details. This action cannot be undone.

Path Parameters

uuid string*

UUID of the lead to delete

Responses

200 Lead deleted successfully

Lead deleted successfully

status integer

400 Bad request. Possible `error_code` values:

Bad request. Possible error_code values:

Code	Description
`1002`	ResourceNotFound

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Retrieve a lead

Bulk upgrade leads to customers

/leads/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/leads/{uuid}", {
2   method: "DELETE",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/leads/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Delete.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200
}

1	const response = await fetch("https://api.tamio.com/v2/leads/{uuid}", {
2	method: "DELETE",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/leads/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Delete.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body