{
"webhook_type": "invoice.drafted",
"object_type": "invoice",
"organization_id": "00000000-0000-4000-8000-000000000001",
"invoice": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"billing_entity_code": "pullse_testing",
"sequential_id": null,
"number": "PUL-CDDE-DRAFT",
"issuing_date": "2026-10-21",
"payment_due_date": "2026-10-21",
"net_payment_term": 0,
"invoice_type": "subscription",
"status": "draft",
"payment_status": "succeeded",
"payment_dispute_lost_at": null,
"payment_overdue": false,
"currency": "USD",
"fees_amount_cents": 0,
"taxes_amount_cents": 0,
"progressive_billing_credit_amount_cents": 0,
"coupons_amount_cents": 0,
"credit_notes_amount_cents": 0,
"sub_total_excluding_taxes_amount_cents": 0,
"sub_total_including_taxes_amount_cents": 0,
"total_amount_cents": 0,
"total_due_amount_cents": 0,
"total_paid_amount_cents": 0,
"total_offsetted_credit_note_amount_cents": 0,
"prepaid_credit_amount_cents": 0,
"prepaid_granted_credit_amount_cents": null,
"prepaid_purchased_credit_amount_cents": null,
"file_url": null,
"xml_url": null,
"version_number": 4,
"self_billed": false,
"created_at": "2026-10-16T16:30:47Z",
"updated_at": "2026-10-16T16:30:47Z",
"voided_at": null,
"customer": {
"nozle_id": "00000000-0000-4000-8000-000000000003",
"billing_entity_code": "pullse_testing",
"external_id": "st_cancel_no_replacement_1792168246841157576",
"account_type": "customer",
"name": "cancel_no_replacement",
"firstname": null,
"lastname": null,
"customer_type": null,
"sequential_id": 507,
"slug": "PUL-CDDE-507",
"created_at": "2026-10-16T16:30:46Z",
"updated_at": "2026-10-16T16:30:46Z",
"country": null,
"address_line1": null,
"address_line2": null,
"state": null,
"zipcode": null,
"email": null,
"city": null,
"url": null,
"phone": null,
"logo_url": null,
"legal_name": null,
"legal_number": null,
"currency": "USD",
"tax_identification_number": null,
"timezone": null,
"applicable_timezone": "Asia/Kolkata",
"net_payment_term": null,
"external_salesforce_id": null,
"finalize_zero_amount_invoice": "inherit",
"billing_configuration": {
"invoice_grace_period": null,
"payment_provider": null,
"payment_provider_code": null,
"document_locale": null,
"subscription_invoice_issuing_date_anchor": null,
"subscription_invoice_issuing_date_adjustment": null
},
"shipping_address": {
"address_line1": null,
"address_line2": null,
"city": null,
"zipcode": null,
"state": null,
"country": null
},
"skip_invoice_custom_sections": false,
"metadata": []
},
"subscriptions": [
{
"nozle_id": "00000000-0000-4000-8000-000000000004",
"external_id": "st_cancel_no_replacement_sub_1792168246841157576",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "st_cancel_no_replacement_1792168246841157576",
"name": "",
"plan_code": "qa_top_rev_10110831",
"plan_amount_cents": 0,
"plan_amount_currency": "USD",
"status": "terminated",
"billing_authority": "nozle",
"credit_import_completed_at": null,
"billing_time": "calendar",
"subscription_at": "2026-10-16T16:30:46Z",
"started_at": "2026-10-16T16:30:46.902Z",
"trial_ended_at": null,
"ending_at": null,
"terminated_at": "2026-10-16T16:30:47Z",
"canceled_at": null,
"created_at": "2026-10-16T16:30:46Z",
"previous_plan_code": null,
"next_plan_code": null,
"downgrade_plan_date": null,
"current_billing_period_started_at": "2026-10-16T16:30:46Z",
"current_billing_period_ending_at": "2026-10-16T16:30:47Z",
"on_termination_credit_note": null,
"on_termination_invoice": "generate",
"progressive_billing_disabled": false,
"consolidate_invoice": true,
"purchase_order_number": null,
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
}
}
],
"billing_periods": [
{
"subscription_id": "00000000-0000-4000-8000-000000000004",
"external_subscription_id": "st_cancel_no_replacement_sub_1792168246841157576",
"plan_id": "00000000-0000-4000-8000-000000000005",
"subscription_from_datetime": "2026-10-15T18:30:00Z",
"subscription_to_datetime": "2026-10-16T16:30:47Z",
"charges_from_datetime": "2026-10-16T16:30:46Z",
"charges_to_datetime": "2026-10-16T16:30:47Z",
"fixed_charges_from_datetime": "2026-10-16T16:30:46Z",
"fixed_charges_to_datetime": "2026-10-16T16:30:47Z",
"invoicing_reason": "subscription_terminating"
}
],
"fees": [
{
"nozle_id": "00000000-0000-4000-8000-000000000006",
"charge_id": null,
"charge_filter_id": null,
"fixed_charge_id": null,
"invoice_id": "00000000-0000-4000-8000-000000000002",
"true_up_fee_id": null,
"true_up_parent_fee_id": null,
"original_fee_id": null,
"subscription_id": "00000000-0000-4000-8000-000000000004",
"external_subscription_id": "st_cancel_no_replacement_sub_1792168246841157576",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "st_cancel_no_replacement_1792168246841157576",
"item": {
"type": "subscription",
"code": "qa_top_rev_10110831",
"name": "QA Top Rev Usage",
"description": null,
"invoice_display_name": "QA Top Rev Usage",
"filters": null,
"filter_invoice_display_name": null,
"item_id": "00000000-0000-4000-8000-000000000004",
"item_type": "Subscription",
"grouped_by": {}
},
"pay_in_advance": false,
"invoiceable": true,
"amount_cents": 0,
"amount_currency": "USD",
"precise_amount": "0.0",
"precise_total_amount": "0.0",
"taxes_amount_cents": 0,
"taxes_precise_amount": "0.0",
"taxes_rate": 0,
"total_aggregated_units": null,
"total_amount_cents": 0,
"total_amount_currency": "USD",
"units": "1.0",
"description": null,
"precise_unit_amount": "0.0",
"precise_coupons_amount_cents": "0.0",
"sub_total_excluding_taxes_amount_cents": 0,
"sub_total_excluding_taxes_precise_amount_cents": "0.0",
"events_count": null,
"payment_status": "pending",
"created_at": "2026-10-16T16:30:47Z",
"succeeded_at": null,
"failed_at": null,
"refunded_at": null,
"amount_details": {
"plan_amount_cents": 0
},
"self_billed": false,
"pricing_unit_details": null,
"presentation_breakdowns": [],
"from_date": "2026-10-15T18:30:00+00:00",
"to_date": "2026-10-16T16:30:47+00:00"
}
],
"credits": [],
"applied_taxes": [],
"error_details": []
}
}Invoices
A new draft invoice has been emitted
An invoice is created as a draft, while it is in its grace period or has been refreshed.
WEBHOOK
invoice_drafted
{
"webhook_type": "invoice.drafted",
"object_type": "invoice",
"organization_id": "00000000-0000-4000-8000-000000000001",
"invoice": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"billing_entity_code": "pullse_testing",
"sequential_id": null,
"number": "PUL-CDDE-DRAFT",
"issuing_date": "2026-10-21",
"payment_due_date": "2026-10-21",
"net_payment_term": 0,
"invoice_type": "subscription",
"status": "draft",
"payment_status": "succeeded",
"payment_dispute_lost_at": null,
"payment_overdue": false,
"currency": "USD",
"fees_amount_cents": 0,
"taxes_amount_cents": 0,
"progressive_billing_credit_amount_cents": 0,
"coupons_amount_cents": 0,
"credit_notes_amount_cents": 0,
"sub_total_excluding_taxes_amount_cents": 0,
"sub_total_including_taxes_amount_cents": 0,
"total_amount_cents": 0,
"total_due_amount_cents": 0,
"total_paid_amount_cents": 0,
"total_offsetted_credit_note_amount_cents": 0,
"prepaid_credit_amount_cents": 0,
"prepaid_granted_credit_amount_cents": null,
"prepaid_purchased_credit_amount_cents": null,
"file_url": null,
"xml_url": null,
"version_number": 4,
"self_billed": false,
"created_at": "2026-10-16T16:30:47Z",
"updated_at": "2026-10-16T16:30:47Z",
"voided_at": null,
"customer": {
"nozle_id": "00000000-0000-4000-8000-000000000003",
"billing_entity_code": "pullse_testing",
"external_id": "st_cancel_no_replacement_1792168246841157576",
"account_type": "customer",
"name": "cancel_no_replacement",
"firstname": null,
"lastname": null,
"customer_type": null,
"sequential_id": 507,
"slug": "PUL-CDDE-507",
"created_at": "2026-10-16T16:30:46Z",
"updated_at": "2026-10-16T16:30:46Z",
"country": null,
"address_line1": null,
"address_line2": null,
"state": null,
"zipcode": null,
"email": null,
"city": null,
"url": null,
"phone": null,
"logo_url": null,
"legal_name": null,
"legal_number": null,
"currency": "USD",
"tax_identification_number": null,
"timezone": null,
"applicable_timezone": "Asia/Kolkata",
"net_payment_term": null,
"external_salesforce_id": null,
"finalize_zero_amount_invoice": "inherit",
"billing_configuration": {
"invoice_grace_period": null,
"payment_provider": null,
"payment_provider_code": null,
"document_locale": null,
"subscription_invoice_issuing_date_anchor": null,
"subscription_invoice_issuing_date_adjustment": null
},
"shipping_address": {
"address_line1": null,
"address_line2": null,
"city": null,
"zipcode": null,
"state": null,
"country": null
},
"skip_invoice_custom_sections": false,
"metadata": []
},
"subscriptions": [
{
"nozle_id": "00000000-0000-4000-8000-000000000004",
"external_id": "st_cancel_no_replacement_sub_1792168246841157576",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "st_cancel_no_replacement_1792168246841157576",
"name": "",
"plan_code": "qa_top_rev_10110831",
"plan_amount_cents": 0,
"plan_amount_currency": "USD",
"status": "terminated",
"billing_authority": "nozle",
"credit_import_completed_at": null,
"billing_time": "calendar",
"subscription_at": "2026-10-16T16:30:46Z",
"started_at": "2026-10-16T16:30:46.902Z",
"trial_ended_at": null,
"ending_at": null,
"terminated_at": "2026-10-16T16:30:47Z",
"canceled_at": null,
"created_at": "2026-10-16T16:30:46Z",
"previous_plan_code": null,
"next_plan_code": null,
"downgrade_plan_date": null,
"current_billing_period_started_at": "2026-10-16T16:30:46Z",
"current_billing_period_ending_at": "2026-10-16T16:30:47Z",
"on_termination_credit_note": null,
"on_termination_invoice": "generate",
"progressive_billing_disabled": false,
"consolidate_invoice": true,
"purchase_order_number": null,
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
}
}
],
"billing_periods": [
{
"subscription_id": "00000000-0000-4000-8000-000000000004",
"external_subscription_id": "st_cancel_no_replacement_sub_1792168246841157576",
"plan_id": "00000000-0000-4000-8000-000000000005",
"subscription_from_datetime": "2026-10-15T18:30:00Z",
"subscription_to_datetime": "2026-10-16T16:30:47Z",
"charges_from_datetime": "2026-10-16T16:30:46Z",
"charges_to_datetime": "2026-10-16T16:30:47Z",
"fixed_charges_from_datetime": "2026-10-16T16:30:46Z",
"fixed_charges_to_datetime": "2026-10-16T16:30:47Z",
"invoicing_reason": "subscription_terminating"
}
],
"fees": [
{
"nozle_id": "00000000-0000-4000-8000-000000000006",
"charge_id": null,
"charge_filter_id": null,
"fixed_charge_id": null,
"invoice_id": "00000000-0000-4000-8000-000000000002",
"true_up_fee_id": null,
"true_up_parent_fee_id": null,
"original_fee_id": null,
"subscription_id": "00000000-0000-4000-8000-000000000004",
"external_subscription_id": "st_cancel_no_replacement_sub_1792168246841157576",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "st_cancel_no_replacement_1792168246841157576",
"item": {
"type": "subscription",
"code": "qa_top_rev_10110831",
"name": "QA Top Rev Usage",
"description": null,
"invoice_display_name": "QA Top Rev Usage",
"filters": null,
"filter_invoice_display_name": null,
"item_id": "00000000-0000-4000-8000-000000000004",
"item_type": "Subscription",
"grouped_by": {}
},
"pay_in_advance": false,
"invoiceable": true,
"amount_cents": 0,
"amount_currency": "USD",
"precise_amount": "0.0",
"precise_total_amount": "0.0",
"taxes_amount_cents": 0,
"taxes_precise_amount": "0.0",
"taxes_rate": 0,
"total_aggregated_units": null,
"total_amount_cents": 0,
"total_amount_currency": "USD",
"units": "1.0",
"description": null,
"precise_unit_amount": "0.0",
"precise_coupons_amount_cents": "0.0",
"sub_total_excluding_taxes_amount_cents": 0,
"sub_total_excluding_taxes_precise_amount_cents": "0.0",
"events_count": null,
"payment_status": "pending",
"created_at": "2026-10-16T16:30:47Z",
"succeeded_at": null,
"failed_at": null,
"refunded_at": null,
"amount_details": {
"plan_amount_cents": 0
},
"self_billed": false,
"pricing_unit_details": null,
"presentation_breakdowns": [],
"from_date": "2026-10-15T18:30:00+00:00",
"to_date": "2026-10-16T16:30:47+00:00"
}
],
"credits": [],
"applied_taxes": [],
"error_details": []
}
}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 invoice
Available options:
invoice.drafted Available options:
invoice Unique identifier of the organization, created by Nozle.
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Show child attributes
Show child attributes
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.