Operations API Customers

Create an address for a customer

POST https://api.tamio.com/v2/customers/address/create/{uuid}

Adds a new billing or shipping address to an existing customer.

Path Parameters

uuid string*

UUID of the customer

Body Parameters

name string*

Contact first name

last_name string

Contact last name

country string*

Two-letter ISO country code

address string*

Street address

city string*

City

company string

Company name

postcode string

Postal/zip code

state string

State or province

email string

Contact email address

phone string

Contact phone number

vat string

VAT identification number (billing addresses only)

locale string

Preferred language/locale

is_company boolean

Whether the billing entity is a company

representative string

Authorized representative name (for company billing)

shipping_address boolean

Set to true to create a shipping address instead of a billing address

Example

{
  "name": "John",
  "last_name": "Doe",
  "country": "de",
  "address": "123 Main St",
  "city": "Berlin",
  "postcode": "10115",
  "email": "[email protected]",
  "phone": "+49123456789",
  "locale": "de",
  "is_company": false,
  "shipping_address": false
}

Responses

200 Address created successfully

Address created successfully

status integer

customer Customer

400 Validation or business-logic error.

Code	Description
`1002`	Customer not found

401 Unauthorized – invalid or missing Bearer token

Assign customers to a teammate

Update an address

/customers/address/create/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/customers/address/create/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "name": "John",
9     "last_name": "Doe",
10     "country": "de",
11     "address": "123 Main St",
12     "city": "Berlin",
13     "postcode": "10115",
14     "email": "[email protected]",
15     "phone": "+49123456789",
16     "locale": "de",
17     "is_company": false,
18     "shipping_address": false
19   })
20 });
21 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/customers/address/create/{uuid}")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   name: "John",
16   last_name: "Doe",
17   country: "de",
18   address: "123 Main St",
19   city: "Berlin",
20   postcode: "10115",
21   email: "[email protected]",
22   phone: "+49123456789",
23   locale: "de",
24   is_company: false,
25   shipping_address: false
26 }.to_json
27 
28 response = https.request(request)
29 puts response.read_body

Responses

{
  "status": 200,
  "customer": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "customer",
    "email": "[email protected]",
    "name": "John",
    "last_name": "Doe",
    "country": "de",
    "locale": "en",
    "timezone_offset": "+00:00",
    "phone": "+49123456789",
    "stripe_customer_id": "cus_P2BjgLkL",
    "teammate_id": "cc6e91ea-0275-408a-8106-25f0e3fcbd83",
    "affiliate_partner_id": "bb6e91ea-0275-408a-8106-25f0e3fcbd82",
    "has_notes": false,
    "created_at": 1700000000,
    "billing_addresses": [
      {
        "id": "0380f2d4-1a26-4074-8b6b-87b64f3d1b6e",
        "object": "address",
        "name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "address": "123 Main St",
        "city": "New York",
        "postcode": "10001",
        "state": "NY",
        "country": "us",
        "locale": "en",
        "phone": "+441234567890",
        "company": "Tamio Inc",
        "message": "Leave at front door",
        "shipping_address": false,
        "is_company": true,
        "vat": "US12345678",
        "verified_vat": true,
        "custom_billing_fields": {}
      }
    ],
    "shipping_addresses": [
      {
        "id": "0380f2d4-1a26-4074-8b6b-87b64f3d1b6e",
        "object": "address",
        "name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "address": "123 Main St",
        "city": "New York",
        "postcode": "10001",
        "state": "NY",
        "country": "us",
        "locale": "en",
        "phone": "+441234567890",
        "company": "Tamio Inc",
        "message": "Leave at front door",
        "shipping_address": false,
        "is_company": true,
        "vat": "US12345678",
        "verified_vat": true,
        "custom_billing_fields": {}
      }
    ],
    "direct_debits": [
      {
        "currency": "EUR",
        "provider": "gocardless"
      }
    ],
    "client_id": "aa6e91ea-0275-408a-8106-25f0e3fcbd81",
    "category": "VIP"
  }
}

1	const response = await fetch("https://api.tamio.com/v2/customers/address/create/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"name": "John",
9	"last_name": "Doe",
10	"country": "de",
11	"address": "123 Main St",
12	"city": "Berlin",
13	"postcode": "10115",
14	"email": "[email protected]",
15	"phone": "+49123456789",
16	"locale": "de",
17	"is_company": false,
18	"shipping_address": false
19	})
20	});
21	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/customers/address/create/{uuid}")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	name: "John",
16	last_name: "Doe",
17	country: "de",
18	address: "123 Main St",
19	city: "Berlin",
20	postcode: "10115",
21	email: "[email protected]",
22	phone: "+49123456789",
23	locale: "de",
24	is_company: false,
25	shipping_address: false
26	}.to_json
27
28	response = https.request(request)
29	puts response.read_body