Delete subscription event
Delete a subscription event. Its `mrrChange` is removed from every period after its `effectiveTime`, so deleting the wrong row leaves a subscription permanently over- or under-counted. To end a subscription, add a cancelling event rather than deleting the ones that created it.
Authentication
sf_… API key in the bearerAuth field below.A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.
In: header
Path Parameters
1 <= length1 <= lengthResponse Body
application/json
application/json
curl -X DELETE "https://example.com/companies/string/subscription_events/string"{ "success": true}Create subscription event
Record a subscription event, which is how revenue actually enters SaaSFlow. `mrrChange` is a signed delta in the subscription's currency, sent as a decimal string so nothing is lost to floating point: positive for a new subscription or an upgrade, negative for a downgrade, and the negative of everything booked so far for a full cancellation. `quantityChange` is the matching seat or unit delta. `effectiveTime` is when the change hits MRR and `committedTime` is when it was agreed, and getting the two the wrong way round is the usual cause of MRR landing in the wrong month. Fails with 404 if the subscription is not in this company.
Update subscription event
Correct a subscription event. Only the fields you send change. Because events are deltas, editing one rewrites MRR from its `effectiveTime` onward, so a correction here moves historical numbers rather than only affecting the present. Events mirrored from a billing provider are overwritten on the next sync; fix those at the source.