Add a subscriber to a mailing list

POST https://api.tamio.com/v2/mailing-lists/add-subscriber/{uuid}

Adds a subscriber to the specified mailing list. If the subscriber does not exist, a new subscriber and associated lead record are created. If the subscriber already exists, they are associated with the list without duplication.

Path Parameters

uuid string*

UUID of the mailing list to add the subscriber to

Body Parameters

email string*

Subscriber's email address

first_name string*

Subscriber's first name

last_name string

Subscriber's last name

Responses

200 Subscriber added to mailing list successfully

Subscriber added to mailing list successfully

status integer

mailing_list MailingList

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Mailing list not found

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Bulk delete mailing lists

/mailing-lists/add-subscriber/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/mailing-lists/add-subscriber/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "email": "[email protected]",
9     "first_name": "John",
10     "last_name": "Doe"
11   })
12 });
13 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/mailing-lists/add-subscriber/{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   email: "[email protected]",
16   first_name: "John",
17   last_name: "Doe"
18 }.to_json
19 
20 response = https.request(request)
21 puts response.read_body

Responses

{
  "status": 200,
  "mailing_list": {
    "id": "00000000-0000-0000-0000-000000000000",
    "object": "mailing_list",
    "label": "VIP Customers",
    "created_at": 1700000000,
    "number_of_subscribers": 245,
    "number_of_newsletters": 12,
    "audience": {},
    "last_campaign_date": 1704153600
  }
}

1	const response = await fetch("https://api.tamio.com/v2/mailing-lists/add-subscriber/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"email": "[email protected]",
9	"first_name": "John",
10	"last_name": "Doe"
11	})
12	});
13	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/mailing-lists/add-subscriber/{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	email: "[email protected]",
16	first_name: "John",
17	last_name: "Doe"
18	}.to_json
19
20	response = https.request(request)
21	puts response.read_body