TrialMonitor Get Started Free

Segment-Change Webhooks

Automate actions when trial users move between segments.

trial.segment_changed

{

"event": "trial.segment_changed",

"user_id": "usr_8a3f...",

"old_segment": "exploring",

"new_segment": "found_value",

"trial_end": "2025-02-28",

"reason": "aha_event"

}

When a trial user moves between segments, TrialMonitor fires a webhook to your configured URL so your systems can react automatically. No polling, no manual checks - just real-time notifications with full context.

Manual follow-up does not scale

Checking a dashboard every hour and sending emails by hand works when you have five trial users. It breaks down at fifty. You need segment changes to trigger actions in your existing tools automatically.

Whether you want to send a targeted email when someone goes quiet, update a deal stage in your CRM when a user finds value, or log segment transitions in your own backend - webhooks let you connect TrialMonitor to everything else.

How it works

Every time a trial user transitions from one segment to another, TrialMonitor sends a POST request to your configured webhook URL. Each payload is HMAC-signed so you can verify it came from TrialMonitor.

The payload includes everything you need to act: the old and new segment, a reason code explaining what triggered the change, the user's trial dates, and their identity (Stripe customer ID, email, and your user ID).

What is in the payload

POST /your-webhook-url

{

"event": "trial.segment_changed",

"app_id": "app_1a2b3c",

"trial": {

"user_id": "usr_8a3f4b",

"email": "alex@example.com",

"stripe_customer_id": "cus_Abc123",

"trial_start": "2025-02-14T00:00:00Z",

"trial_end": "2025-02-28T00:00:00Z"

},

"old_segment": "exploring",

"new_segment": "found_value",

"reason": "aha_event_received",

"occurred_at": "2025-02-16T14:32:00Z"

}

Every payload is signed with an HMAC-SHA256 signature in the request headers. Verify the signature in your handler to confirm the webhook came from TrialMonitor.

What you can connect

Email service provider

Send targeted emails based on the new segment. A "gone quiet" transition triggers a check-in. A "found value" transition triggers a conversion nudge.

CRM

Update deal stages automatically. When a trial user moves to "on track to convert", move them to your hot leads pipeline.

Zapier, n8n, or Make

Connect to 8,000+ apps without writing code. Use webhooks as a trigger in any automation platform you prefer.

Your own backend

Build custom logic in your application. Log transitions, update internal flags, trigger in-app messaging - whatever your product needs.

Getting started

Add your webhook URL in your app's Settings page. TrialMonitor will start sending segment-change events immediately. Use the built-in webhook tester to verify your endpoint is receiving payloads correctly before going live.

Get Started