{
"webhook_type": "subscription.started",
"object_type": "subscription",
"organization_id": "00000000-0000-4000-8000-000000000001",
"subscription": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"external_id": "issue11_llm_sub",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "issue11_llm_cust",
"name": "",
"plan_code": "issue11_llm_plan",
"plan_amount_cents": 0,
"plan_amount_currency": "USD",
"status": "active",
"billing_authority": "nozle",
"credit_import_completed_at": null,
"billing_time": "calendar",
"subscription_at": "2026-10-17T02:02:32Z",
"started_at": "2026-10-17T02:02:32.080Z",
"trial_ended_at": null,
"ending_at": null,
"terminated_at": null,
"canceled_at": null,
"created_at": "2026-10-17T02:02:32Z",
"previous_plan_code": null,
"next_plan_code": null,
"downgrade_plan_date": null,
"current_billing_period_started_at": "2026-10-17T02:02:32Z",
"current_billing_period_ending_at": "2026-10-31T18:29:59Z",
"on_termination_credit_note": null,
"on_termination_invoice": "generate",
"progressive_billing_disabled": false,
"consolidate_invoice": true,
"purchase_order_number": null,
"customer": {
"nozle_id": "00000000-0000-4000-8000-000000000003",
"billing_entity_code": "pullse_testing",
"external_id": "issue11_llm_cust",
"account_type": "customer",
"name": "Issue11 LLM customer",
"firstname": null,
"lastname": null,
"customer_type": null,
"sequential_id": 509,
"slug": "PUL-CDDE-509",
"created_at": "2026-10-17T02:02:31Z",
"updated_at": "2026-10-17T02:02:31Z",
"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": []
},
"entitlements": [],
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
},
"plan": {
"nozle_id": "00000000-0000-4000-8000-000000000004",
"name": "Issue11 LLM plan",
"invoice_display_name": null,
"created_at": "2026-10-17T02:02:31Z",
"code": "issue11_llm_plan",
"interval": "monthly",
"description": null,
"amount_cents": 0,
"amount_currency": "USD",
"trial_period": null,
"pay_in_advance": false,
"bill_charges_monthly": null,
"bill_fixed_charges_monthly": null,
"parent_id": null,
"pending_deletion": false,
"plan_family_code": "issue11_llm_plan",
"charges": [
{
"nozle_id": "00000000-0000-4000-8000-000000000005",
"feature_id": "00000000-0000-4000-8000-000000000006",
"code": "llm_tokens",
"invoice_display_name": null,
"feature_code": "llm_tokens",
"created_at": "2026-10-17T02:02:31Z",
"charge_model": "standard",
"invoiceable": true,
"regroup_paid_fees": null,
"pay_in_advance": false,
"prorated": false,
"min_amount_cents": 0,
"accepts_target_wallet": false,
"properties": {
"amount": "0.001"
},
"applied_pricing_unit": null,
"parent_id": null,
"filters": [],
"taxes": []
}
],
"usage_thresholds": [],
"applicable_usage_thresholds": [],
"taxes": []
}
}
}Subscriptions and Fees
An subscription has started
A subscription starts or is activated, including the new subscription of a plan change.
WEBHOOK
subscription_started
{
"webhook_type": "subscription.started",
"object_type": "subscription",
"organization_id": "00000000-0000-4000-8000-000000000001",
"subscription": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"external_id": "issue11_llm_sub",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "issue11_llm_cust",
"name": "",
"plan_code": "issue11_llm_plan",
"plan_amount_cents": 0,
"plan_amount_currency": "USD",
"status": "active",
"billing_authority": "nozle",
"credit_import_completed_at": null,
"billing_time": "calendar",
"subscription_at": "2026-10-17T02:02:32Z",
"started_at": "2026-10-17T02:02:32.080Z",
"trial_ended_at": null,
"ending_at": null,
"terminated_at": null,
"canceled_at": null,
"created_at": "2026-10-17T02:02:32Z",
"previous_plan_code": null,
"next_plan_code": null,
"downgrade_plan_date": null,
"current_billing_period_started_at": "2026-10-17T02:02:32Z",
"current_billing_period_ending_at": "2026-10-31T18:29:59Z",
"on_termination_credit_note": null,
"on_termination_invoice": "generate",
"progressive_billing_disabled": false,
"consolidate_invoice": true,
"purchase_order_number": null,
"customer": {
"nozle_id": "00000000-0000-4000-8000-000000000003",
"billing_entity_code": "pullse_testing",
"external_id": "issue11_llm_cust",
"account_type": "customer",
"name": "Issue11 LLM customer",
"firstname": null,
"lastname": null,
"customer_type": null,
"sequential_id": 509,
"slug": "PUL-CDDE-509",
"created_at": "2026-10-17T02:02:31Z",
"updated_at": "2026-10-17T02:02:31Z",
"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": []
},
"entitlements": [],
"payment_method": {
"payment_method_id": null,
"payment_method_type": "provider"
},
"plan": {
"nozle_id": "00000000-0000-4000-8000-000000000004",
"name": "Issue11 LLM plan",
"invoice_display_name": null,
"created_at": "2026-10-17T02:02:31Z",
"code": "issue11_llm_plan",
"interval": "monthly",
"description": null,
"amount_cents": 0,
"amount_currency": "USD",
"trial_period": null,
"pay_in_advance": false,
"bill_charges_monthly": null,
"bill_fixed_charges_monthly": null,
"parent_id": null,
"pending_deletion": false,
"plan_family_code": "issue11_llm_plan",
"charges": [
{
"nozle_id": "00000000-0000-4000-8000-000000000005",
"feature_id": "00000000-0000-4000-8000-000000000006",
"code": "llm_tokens",
"invoice_display_name": null,
"feature_code": "llm_tokens",
"created_at": "2026-10-17T02:02:31Z",
"charge_model": "standard",
"invoiceable": true,
"regroup_paid_fees": null,
"pay_in_advance": false,
"prorated": false,
"min_amount_cents": 0,
"accepts_target_wallet": false,
"properties": {
"amount": "0.001"
},
"applied_pricing_unit": null,
"parent_id": null,
"filters": [],
"taxes": []
}
],
"usage_thresholds": [],
"applicable_usage_thresholds": [],
"taxes": []
}
}
}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 subscription
Available options:
subscription.started Available options:
subscription 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.