Create a lead

POST https://api.tamio.com/v2/leads/create

Creates a new lead with contact information, priority level, status tracking, and optional billing/shipping address details. Supports lead assignment to teammates.

Body Parameters

name string*

Lead's first name or full name

last_name string

Lead's last name

email string*

Lead's primary email address

country string*

Lead's country code

priority string*

Lead priority level for sales team prioritization

lownormalmediumhigh

lead_status string*

Current status in the lead qualification process

new_leadqualifiedunqualifiedcontactedfollowupattempt_to_contact

category string

Lead classification

leadcustomer

locale string

Preferred language for communications

phone string

Primary contact phone number

timezone_offset string

Timezone offset in UTC format

teammate_id string

UUID of team member to assign this lead to

same_shipping_address boolean

Whether shipping address is the same as billing

billing_information BillingInformation

shipping_information ShippingInformation

Responses

200 Lead created successfully

Lead created successfully

status integer

customer Lead

400 Bad request. Possible `error_code` values:

Bad request. Possible error_code values:

Code	Description
`10142`	CustomerAlreadyExists

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Retrieve a lead

/leads/create

1 const response = await fetch("https://api.tamio.com/v2/leads/create", {
2   method: "POST",
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/create")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "customer": {
    "id": "string",
    "object": "customer",
    "name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "country": "de",
    "locale": "en",
    "phone": "+49 123 456",
    "category": "lead",
    "priority": "normal",
    "lead_status": "new_lead",
    "timezone_offset": "+02:00",
    "teammate_id": "string",
    "created_at": 1700000000,
    "addresses": []
  }
}

1	const response = await fetch("https://api.tamio.com/v2/leads/create", {
2	method: "POST",
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/create")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body