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.

Webhook verification

Webhooks created through the API can be verified by using the endpoint below.
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 webhook ID from the webhook evt_JsOKTu2rlzjZsxPaleUx
4 session Session ID from the coupon 8yx7hpxuu69k0zga93nix
	$ch = curl_init();
	$url = "";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	$data = [
		'webhook' => "evt_JsOKTu2rlzjZsxPaleUx"
	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 success response
					"status": {
						"status": "OK"
					"result": "valid",
					"webhook": "evt_JsOKTu2rlzjZsxPaleUx",
					"date": "2017-10-09 09:57:57",
					"campaign": "cam_12345",
					"session": "8yx7hpxuu69k0zga93nix",
					"type": "coupon_validated"
Example failed response
					"status": {
						"status": "failed",
						"errors": {
							"error_message": "HTTP/1.0 422 Unprocessable entity.",
							"error_message_description": [
								"Webhook not found."
							"error_code": [
Possible errors
  • 200: Missing parameter: session
  • 200: Missing parameter: webhook
  • 301: Invalid character in parameter: session.
  • 301: Invalid character in parameter: webhook.
  • 509: Webhook not found.

  • 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