Home · Webhooks & events
Webhooks & events

Webhooks & events

10 signed lifecycle events to connect Florentin with third-party systems and automations — marketing, CRM, n8n, Make, Zapier. With retries and delivery logs.

What webhooks are for

Your own app doesn't need webhooks — it reads Florentin directly via the API. Webhooks exist so other systems can react: Florentin sends signed events to your marketing platform, your CRM or automation tools like n8n, Make and Zapier the moment something happens — an account is created, a subscription is cancelled, an invoice is created.

Every delivery is HMAC-SHA256-signed, carries event, timestamp and delivery-id headers and is retried automatically on failure.

Events

The 10 events

EventTrigger
account.createdNew account created
user.loginLogin occurred
subscription.purchasedSubscription purchased
invoice.createdInvoice created
subscription.upgradedPlan upgraded
subscription.downgradedPlan downgraded
subscription.cancelledSubscription cancelled
team_member.addedTeam member added
tos.acceptedTerms accepted
usage.metrics_updatedUsage metrics updated

Delivery

SignatureX-Florentin-Signature: sha256=<hmac>
HeadersX-Florentin-Event · -Timestamp · -Delivery-Id
Retries4 attempts: 30 / 120 / 300 s.
LogsAttempts, status, replay.

Example payload

POST /hooks/florentin
X-Florentin-Event: invoice.created
X-Florentin-Signature: sha256=8f3c9d…
X-Florentin-Delivery-Id: 7c1f…

{
  "event": "invoice.created",
  "timestamp": "2026-06-06T12:00:00.000Z",
  "data": {
    "invoice": { "id": "…", "number": "INV-0042",
                 "status": "open", "amount_due": 4900, "currency": "eur" }
  }
}
FAQ

Frequently asked

How do I verify the signature?
Via the secret: X-Florentin-Signature = sha256=HMAC-SHA256(secret, raw body).
What if my endpoint is down?
Florentin retries up to 4× (backoff 30 / 120 / 300 s) and logs every attempt.

Build your product. We'll handle the rest.

Accounts, billing, credits, portal, access — integrated. Stripe fully included.

Start free