> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmhouse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Klaviyo metric webhooks integration

> Send Firmhouse outgoing webhook events directly to Klaviyo as metrics so you can use subscription events as triggers in flows and segmentation.

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:

```json theme={null}
{
  "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**.

To send a manual test to Klaviyo, open the saved webhook and click **Send test event**. Firmhouse uses the saved template with sample subscription data, then sends the final Klaviyo event body through the connected Klaviyo app.

Klaviyo metric test events use the profile email `john.doe-klaviyo-test@firmhouse.com`. Search for this profile in Klaviyo to confirm that the test metric arrived. Klaviyo can accept events sent to example or fake-looking email domains without showing the event on a profile, so Firmhouse uses a Firmhouse-owned test address for manual Klaviyo metric tests.

## Related articles

* [Use Klaviyo to Send Email Notifications](/configure/customer-communication/using-klaviyo)
* [Adding, managing, and removing webhooks](/configure/integrations/webhooks)