The reason is free text — can I bucket it?

Yes. classify maps the free-text reason to a typed label your pipeline branches on, so price churn and product churn route to different people.

Can I alert only above a revenue threshold?

enrich.entity attaches MRR; a filter then keeps only the cancellations that actually move the number.

Where do I keep churn history?

Send every cancellation to Postgres in parallel with the alert, so the churn table is complete regardless of who got pinged.

ingestlayer/recipes/v0.4

Track canceled subscriptions in Webhook

Catch every cancellation with the plan, the tenure, and the reason attached — so the team can reach out while the relationship is still warm.

01source

sourcesdk.eventTypeScript SDK

matchsubscription.canceled

02pipeline · 2 steps

01ENRclassifyreason → price | missing-feature | switched
02ENRenrich.entitycustomer → MRR · CSM

03destinations · 1

towebhook.outWebhook
urlhttps://api.acme.com/hooks

the event

You emit subscription.canceled with this shape. The TypeScript SDK keeps the call type-safe, and the event is stored whole — so every field below is available to the pipeline by name.

customer_idstring
planstring
mrrnumberminor units lost
reasonstringfree text, optional
tenure_daysnumber

emit it

From your code with the TypeScript SDK — or any language over the REST endpoint and signed webhook ingress.

emit subscription.canceled

import { ingest } from "@ingestlayer/sdk";

await ingest("subscription.canceled", {
  customer_id: sub.customer,
  plan:        sub.plan.nickname,
  mrr:         sub.plan.amount,
  reason:      survey.reason,
  tenure_days: daysSince(sub.created),
}, {
  idempotencyKey: sub.id,
});

route it to Webhook

POST the processed event as JSON to any HTTPS endpoint you control.

01
set the URL
Any HTTPS endpoint. The processed event is delivered as a JSON body on POST.
02
choose auth
None, a bearer token, or HMAC signing. Signed requests carry an X-Ingestlayer-Signature header you verify with your shared secret.
03
confirm receipt
Return a 2xx within the timeout. Non-2xx responses trigger retries with exponential backoff before the delivery dead-letters.

in webhookdelivered

POST /hooks HTTP/1.1
Host: api.acme.com
Content-Type: application/json
X-Ingestlayer-Signature: t=1717000000,v1=9f86d08…

{
  "type": "user.signed_up",
  "payload": { "email": "ada@acme.com", "plan": "pro" }
}

notes

Endpoints must respond within 10 seconds; slower responses are treated as failures and retried.
Retries use exponential backoff for several attempts before dead-lettering — make your handler idempotent.
Verify the HMAC signature before trusting a payload; the raw body is signed, so compute the digest before JSON parsing.

questions

The reason is free text — can I bucket it?: Yes. classify maps the free-text reason to a typed label your pipeline branches on, so price churn and product churn route to different people.
Can I alert only above a revenue threshold?: enrich.entity attaches MRR; a filter then keeps only the cancellations that actually move the number.
Where do I keep churn history?: Send every cancellation to Postgres in parallel with the alert, so the churn table is complete regardless of who got pinged.

build this pipeline or read the quickstart →