> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# credits.granted

> Non-purchase credits were granted to a subscription.

## When this fires

Plan-included credits are granted at the start of every billing period (`reason: "period_reset"`), and manual adjustments from the dashboard grant purchased credits (`reason: "manual_adjustment"`). Purchases through the API, automatic top-ups, or the customer portal fire `credits.purchased` instead.

The idempotency key is derived from the billing operation that granted the credits, so engine retries never send a duplicate.

Use it to reset in-app usage meters at the start of a period or to confirm a support-driven credit grant reached the customer.


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook credits.granted
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.