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.

Send a coupon by SMS

Send a coupon by SMS.
You need to have a SMS marketing platform connected to be able to send out SMS messsages. (Check out: integrations -> SMS marketing)

E.164 phone number format:
First of all, in the international E.164 notation a leading '0' is removed.
The UK mobile phone number '07911 123456' in international format is '+44 7911 123456', so without the first zero.
Secondly in the E.164 notation all spaces, dashes ['-'] and parentheses [ '(' and ')'] are removed, besides the leading '+' all characters should be numeric.
Example: +447911123456
Base URL
# Parameter Input Description
1 client_id API client ID Can be found in your API documentation
2 client_secret API client secret Can be found in your API documentation
3 campaign The unique ID from the campaign Can be found in the list of all campaigns.
4 phone Add the mobile phone number in international E.164 notation.
5 body The SMS body text. The unique coupon URL will be added to each message.
	$ch = curl_init();
	$url = "";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	$data = [
		'campaign' => "cam_123456",
		'phone' => "+123456789"
	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"
			"campaign": "cam_123456",
			"message": "Here comes the body text",
			"phone": "441234567890",
			"single_use_code": "d8ysxk1wqy6ajzh65atx7",
			"single_use_url": "",
			"action": "sms_sent"
Possible errors
  • 103: No SMS integration has been setup in your Coupontools account. Go to 'integrations' and 'SMS marketing' to setup a SMS provider.
  • 200: Missing parameter: campaign
  • 301: Invalid character in parameter: campaign.
  • 301: Phone number not valid
  • 502: Campaign ID not found.
  • 513: Statcode not found
  • 602: SMS not sent to 'phonenr'. Reason: foo
  • 605: SMS not sent to 'phonenr'. Reason: This number is on the blacklist or opt-out list.

  • Inscrivez-vous pour un compte d'essai de 7 jours

    Commencez à utiliser Coupontools dès aujourd'hui !

C'est bien que vous soyez ici ! Des cookies ? Lisez notre déclaration de confidentialité. J'accepte