Skip to main content
Klaviyo Metric Webhooks let you send Firmhouse outgoing webhook events directly to Klaviyo as metrics. Use this when you want Klaviyo flows for events that are not part of Firmhouse email notifications, such as subscription status changes.

​
Before you start

Make sure your project has:
  1. The Klaviyo app enabled and connected.
  2. Customer communication channel set to Klaviyo.
  3. The Klaviyo Metric Webhooks feature enabled from New Features.

​
Create a Klaviyo metric webhook

  1. Go to Apps in the sidebar.
  2. Open Webhooks and click Configure.
  3. Click New outgoing webhook.
  4. Enter a Name. Firmhouse uses this as the Klaviyo metric name.
  5. Set Content type to Klaviyo metric.
  6. Choose the Firmhouse Event that should trigger the Klaviyo metric.
  7. Add a JSON payload template.
  8. Click Save.

​
Template format

The template must render valid JSON. The JSON object becomes the Klaviyo metric properties. Example: 
{
  "subscription_id": "{{ subscription.id }}",
  "full_name": "{{ subscription.full_name }}",
  "status": "{{ subscription.status }}",
  "plan_name": "{{ subscription.active_plan.name }}"
}
If the template renders blank, Firmhouse sends an empty properties object.

​
How delivery works

For Klaviyo metric webhooks:
  • Firmhouse records the metric through the connected Klaviyo app credentials.
  • The webhook Name becomes the Klaviyo metric name.
  • The selected webhook Event controls when the metric is sent.
  • Failed responses are retried automatically up to 3 attempts.

​
Verify and troubleshoot

Open the webhook detail page and inspect Webhook event log:
  • Request body
  • Response code
  • Response body
If a request fails, update your template and use Resend.