Webhooks

Webhooks for Game Leads

Playzo allows you to automatically receive real-time lead data from your game campaigns through Webhooks. This is useful for integrating lead submissions directly into your CRM, database, or marketing automation tools.

When Are Webhooks Triggered?

Webhooks are triggered whenever a user completes a game and becomes a lead. If you’ve configured a webhook URL in your game setup, Playzo will send the lead data immediately after the lead is created.

How to Set a Webhook URL

1. Go to your game campaign dashboard.

2. Click Edit Game Settings.

3. Enter your desired Webhook URL under the “Webhook Notification URL” field.

Payload Structure

When a webhook is triggered, Playzo sends a POST request to your webhook URL with the following JSON payload:

JSON { "game_code": "ABC123", "lead_name": "John Doe", "lead_email": "[e-mail]", "lead_phone": "[phone]", "lead_score": 87, "lead_gender": "male", "lead_coupon": "SAVE20", "created_at": "2025-03-23 15:42:18" }

Field Descriptions:

Field	Description
game_code	Unique code of your game campaign
lead_name	Name of the player who completed the game
lead_email	Email address provided by the player
lead_phone	Phone number provided by the player
lead_score	Score achieved by the user in the game
lead_gender	Gender selected by the user (if asked in the game flow)
lead_coupon	Coupon code generated for the user (if any)
created_at	Timestamp when the lead was created in format YYYY-MM-DD HH:MM:SS

Response Expectations

• Playzo expects a 200 OK HTTP response from your webhook URL.

• If the webhook URL is unreachable or returns an error, it will not retry automatically (yet). Ensure your URL is always reachable and secure.

Security Tip

• Consider adding a secret token or HMAC signature in the headers for authentication.

• Currently, the webhook sends plain data — support for signed requests can be added in future updates.