Coupontools Logo

API & Webhooks

Connect the Coupontools platform with your apps or web projects. The Coupontools REST API allows you to query meta-data about your account, campaigns, distribution, validations, and usage data.

Add a Email subscriber to a group

Add a new subscriber to an existing Email group.
Base URL
POST: https://api4coupons.com/v3/emailtool/addcontact
Parameters
# Parameter Input Description
1 client_id API client ID Can be found in your API documentation
Required
2 client_secret API client secret Can be found in your API documentation
Required
3 emailgroup ID of the Email group Can be found in the Email Group list API endpoint.
Required
4 email A valid email address
Required
5 first_name The subscribers first name
Optional
6 last_name The subscribers last name
Optional
7 custom1 - custom10 User defined fields
Optional
<?php
	$ch = curl_init();
	$url = "https://api4coupons.com/v3/emailtool/addcontact";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	$data = [
		'emailgroup' => "gro_12345",
		'email' => "john@doe.com"
	];
	curl_setopt($ch, CURLOPT_URL, "$url");
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($ch, CURLOPT_VERBOSE, true);
	curl_setopt($ch, CURLOPT_HTTPHEADER, [
		"X-Client-Id: $client_id",
		"X-Client-Secret: $client_secret",
		"Content-Type: application/json",
	]);
	curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
	$response = curl_exec($ch);
?>
Example response
				{
					"status": {
						"status": "OK"
					},
					"group_id": "gro_123456",
					"email": "test@test.com",
					"first_name": "Bill",
					"last_name": "Jackson",
					"result": "saved_succesfully",
					"contact_id": "con_12345678"
				}
				
Example error response
				{
					"status": {
						"status": "OK"
					},
					"group_id": "gro_123456",
					"email": "test@test.com",
					"first_name": "Bill",
					"last_name": "Jackson",
					"result": "already_found"
				}
				
Possible errors
  • 103: Your account is not connected with the Coupontools email services
  • 200: Missing parameter: email.
  • 200: Missing parameter: emailgroup
  • 301: Invalid character in parameter: emailgroup.
  • 303: incorrect format in birthday field, must be yyyy-mm-dd
  • 514: Group ID not found in your account!

  • Regístrate ahora para una cuenta de prueba por 7 días

    ¡Empieza a usar Coupontools hoy!

¡Genial, estás aquí! ¿Cookies? Lee nuestrasPolíticas de Privacidad. Yo acepto
x