Setting Up Push Notification Webhooks

Setting Up Push Notification Webhooks

Follow these steps to add and configure a push notification webhook within any Klaviyo flow. 

Step 1: Add the Webhook to the Flow 

  1. Open your Flow in Klaviyo. 
  2. From the left sidebar (Actions), drag a Webhook component into your flowchart where the notification should trigger. 

Step 2: Configure Settings 

  1. Click the Webhook card in your chart and fill out the left panel: 
  2. Enter a name for the webhook.
  3. Enter the Destination URL using the following format:
    1. {baseUrl}/customer/auth/klaviyo-push-notify/{secret}
    The secret is automatically generated when FTx Control Center is connected to Klaviyo.
    1. Under Body, enter the push notification payload in JSON format.
    JSON Body Fields

                                                                Figure 1.0
    The following fields are required:
    1. external_id: Use {{ person.id }} to identify the customer who should receive the push notification.
    2. title: The headline displayed in the push notification.
    3. message: The main content of the push notification.
    4. campaignId: The campaign ID from FTx Control Center. When provided, the notification is associated with the specified campaign, and customers are redirected to the corresponding campaign details page when they click the notification.
    Alert
    Important: The JSON keys are case-sensitive and required. If any required key is missing or incorrectly formatted, the push notification will not be sent.
    1. Click Save to activate the webhook.
    2. Review the status message displayed by Klaviyo to confirm whether the webhook was configured successfully.
    : Only JSON formatting is supported for the webhook payload.

Step 4: Personalize Your Text (Add Names or Event Details) 

Instead of typing code manually, let Klaviyo generate personalization tags for you: 
  1. Click the grey "View profile & event properties" button at the very bottom left of the panel. 
  2. In the popup window, select what you need: 
    1. "Profile" Tab: For customer details (like First Name, Email). 
    2. "Event" Tab: For action details (like Item Name or Total Price if the flow is triggered by a purchase). 
  3. Click directly on the property name you want to use. Klaviyo will instantly copy the secret code to your clipboard. 
  4. Go back to your JSON box, click inside the quotes of your title or message, and paste it  
  5. Examples of how it looks inside the JSON: 
    1. "title": "Hey {{ person.first_name }}! Your Gift Awaits 🎁" 
    2. "message": "Don't forget! Your {{ event.Item }} is still waiting in your cart." 

Step 5: Save and Go Live 

  1. Click "Save" at the bottom of the Webhook panel. 
  2. Change the webhook status from Draft to Live when you are ready to launch!