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 single push notification

Send a push notification to a single registered wallet user.
Base URL
POST: https://api4coupons.com/v3/loyalty/pushnotification/single
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 loyaltycard ID from the loyaltycard Can be found in the list of all loyalty cards. Example: loy_12345
Required
4 user The unique user (example: lus_12345) Can be found in the webhooks or API call to retrieve all users from a loyalty card.
Required
5 message Your push notification message
Required
<?php
	$ch = curl_init();
	$url = "https://api4coupons.com/v3/loyalty/pushnotification/single";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	$data = [
		'loyaltycard' => "loy_12345",
		'user' => "lus_12345",
		'message' => "Example"
	];
	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"
					}
				}
				
Example error response
				{
					"status": {
						"status": "failed"
					},
					"errors": {
						"error_message": "HTTP/1.0 422 Unprocessable entity.",
						"error_message_description": [
							"Loyaltycard user ID not found."
						],
						"error_code": [
							506
						]
					}
				}
				
Possible errors
  • 200: Missing parameter: campaign.
  • 200: Missing parameter: user
  • 200: Missing parameter: message
  • 301: Invalid character in parameter: loyaltycard.
  • 301: Invalid character in parameter: user.
  • 505: Loyaltycard ID not found.
  • 506: Loyaltycard user ID not found.
  • 507: Error sending push notification
  • 507: 0 users have saved the Loyaltycard.

  • 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
x