Operations API Customers

Bulk add customers to a mailing list

POST https://api.tamio.com/v2/customers/bulk/add-to-list

Adds multiple customers to a mailing list. Customers already subscribed are automatically skipped.

Body Parameters

customers array of string*

Array of customer UUIDs

mailing_list string*

UUID of the mailing list

Example

{
  "customers": [
    "550e8400-e29b-41d4-a716-446655440001",
    "550e8400-e29b-41d4-a716-446655440002"
  ],
  "mailing_list": "880e8400-e29b-41d4-a716-446655440000"
}

Responses

200 Customers added to mailing list

Customers added to mailing list

status integer

customers array of string

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	One or more customers or the mailing list not found

status integer

error string

error_code integer

401 Unauthorized – invalid or missing Bearer token

Add a customer to a mailing list

Remove a customer from a mailing list

/customers/bulk/add-to-list

1 const response = await fetch("https://api.tamio.com/v2/customers/bulk/add-to-list", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "customers": [
9       "550e8400-e29b-41d4-a716-446655440001",
10       "550e8400-e29b-41d4-a716-446655440002"
11     ],
12     "mailing_list": "880e8400-e29b-41d4-a716-446655440000"
13   })
14 });
15 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/bulk/add-to-list")
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   customers: ["550e8400-e29b-41d4-a716-446655440001", "550e8400-e29b-41d4-a716-446655440002"],
16   mailing_list: "880e8400-e29b-41d4-a716-446655440000"
17 }.to_json
18 
19 response = https.request(request)
20 puts response.read_body

Responses

{
  "status": 200,
  "customers": []
}

1	const response = await fetch("https://api.tamio.com/v2/customers/bulk/add-to-list", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"customers": [
9	"550e8400-e29b-41d4-a716-446655440001",
10	"550e8400-e29b-41d4-a716-446655440002"
11	],
12	"mailing_list": "880e8400-e29b-41d4-a716-446655440000"
13	})
14	});
15	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/bulk/add-to-list")
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	customers: ["550e8400-e29b-41d4-a716-446655440001", "550e8400-e29b-41d4-a716-446655440002"],
16	mailing_list: "880e8400-e29b-41d4-a716-446655440000"
17	}.to_json
18
19	response = https.request(request)
20	puts response.read_body