{
"webhook_type": "fee.created",
"object_type": "fee",
"organization_id": "00000000-0000-4000-8000-000000000001",
"fee": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"charge_id": "00000000-0000-4000-8000-000000000003",
"charge_filter_id": null,
"fixed_charge_id": null,
"invoice_id": "00000000-0000-4000-8000-000000000004",
"true_up_fee_id": null,
"true_up_parent_fee_id": null,
"original_fee_id": null,
"subscription_id": "00000000-0000-4000-8000-000000000005",
"external_subscription_id": "swarm-046-sub",
"customer_id": "00000000-0000-4000-8000-000000000006",
"external_customer_id": "swarm-046",
"item": {
"type": "charge",
"code": "api_calls",
"name": "API Calls",
"description": "Count of API calls",
"invoice_display_name": "API Calls",
"filters": null,
"filter_invoice_display_name": null,
"item_id": "00000000-0000-4000-8000-000000000007",
"item_type": "Feature",
"grouped_by": {}
},
"pay_in_advance": false,
"invoiceable": true,
"amount_cents": 25,
"amount_currency": "USD",
"precise_amount": "0.25",
"precise_total_amount": "0.25",
"taxes_amount_cents": 0,
"taxes_precise_amount": "0.0",
"taxes_rate": 0,
"total_aggregated_units": "25.0",
"total_amount_cents": 25,
"total_amount_currency": "USD",
"units": "25.0",
"description": null,
"precise_unit_amount": "0.01",
"precise_coupons_amount_cents": "0.0",
"sub_total_excluding_taxes_amount_cents": 25,
"sub_total_excluding_taxes_precise_amount_cents": "25.0",
"events_count": 25,
"payment_status": "pending",
"created_at": "2026-07-01T00:10:06Z",
"succeeded_at": null,
"failed_at": null,
"refunded_at": null,
"amount_details": {},
"self_billed": false,
"pricing_unit_details": null,
"presentation_breakdowns": [],
"from_date": "2026-06-27T14:19:51+00:00",
"to_date": "2026-06-30T23:59:59+00:00"
}
}Subscriptions and Fees
A pay in advance fee has been created
A pay-in-advance fee is created (an instant usage charge or a non-invoiceable fee).
WEBHOOK
fee_created
{
"webhook_type": "fee.created",
"object_type": "fee",
"organization_id": "00000000-0000-4000-8000-000000000001",
"fee": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"charge_id": "00000000-0000-4000-8000-000000000003",
"charge_filter_id": null,
"fixed_charge_id": null,
"invoice_id": "00000000-0000-4000-8000-000000000004",
"true_up_fee_id": null,
"true_up_parent_fee_id": null,
"original_fee_id": null,
"subscription_id": "00000000-0000-4000-8000-000000000005",
"external_subscription_id": "swarm-046-sub",
"customer_id": "00000000-0000-4000-8000-000000000006",
"external_customer_id": "swarm-046",
"item": {
"type": "charge",
"code": "api_calls",
"name": "API Calls",
"description": "Count of API calls",
"invoice_display_name": "API Calls",
"filters": null,
"filter_invoice_display_name": null,
"item_id": "00000000-0000-4000-8000-000000000007",
"item_type": "Feature",
"grouped_by": {}
},
"pay_in_advance": false,
"invoiceable": true,
"amount_cents": 25,
"amount_currency": "USD",
"precise_amount": "0.25",
"precise_total_amount": "0.25",
"taxes_amount_cents": 0,
"taxes_precise_amount": "0.0",
"taxes_rate": 0,
"total_aggregated_units": "25.0",
"total_amount_cents": 25,
"total_amount_currency": "USD",
"units": "25.0",
"description": null,
"precise_unit_amount": "0.01",
"precise_coupons_amount_cents": "0.0",
"sub_total_excluding_taxes_amount_cents": 25,
"sub_total_excluding_taxes_precise_amount_cents": "25.0",
"events_count": 25,
"payment_status": "pending",
"created_at": "2026-07-01T00:10:06Z",
"succeeded_at": null,
"failed_at": null,
"refunded_at": null,
"amount_details": {},
"self_billed": false,
"pricing_unit_details": null,
"presentation_breakdowns": [],
"from_date": "2026-06-27T14:19:51+00:00",
"to_date": "2026-06-30T23:59:59+00:00"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Signature of the webhook payload
Example:
"Ap¶5ɿΣ6ÐfV£Ä\u0015\u0015ºõÔõÔ[DæAâÿüÚ"
Algorithm used to generate the signature
Available options:
jwt, hmac Example:
"hmac"
Unique id of the webhook. It can be used for idempotency
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Body
application/json
Details of the new fee
Response
200
Return a 2xx status within 30 seconds to acknowledge the delivery. Any other status, a timeout or a connection error is a failed attempt; Nozle makes up to 3 attempts.