> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.teekrr.com/llms.txt.
> For full documentation content, see https://docs.teekrr.com/llms-full.txt.

# Event: billed

POST 

Triggered when reserved credit is **settled** for a recipient — the provider
accepted the message and Teekrr moved the cost from `credit_reserved` into spent.

Most useful for clients who want to mirror Teekrr's billing ledger into their
own accounting system. All amounts are integer cents — divide by 100 for RM.


Reference: https://docs.teekrr.com/api-reference/webhooks/webhook-billed

## OpenAPI 3.1 Webhook Specification

```yaml
openapi: 3.1.0
info:
  title: Teekrr Public API
  version: 1.0.0
paths: {}
webhooks:
  webhook-billed:
    post:
      operationId: webhook-billed
      summary: 'Event: billed'
      description: >
        Triggered when reserved credit is **settled** for a recipient — the
        provider

        accepted the message and Teekrr moved the cost from `credit_reserved`
        into spent.


        Most useful for clients who want to mirror Teekrr's billing ledger into
        their

        own accounting system. All amounts are integer cents — divide by 100 for
        RM.
      responses:
        '200':
          description: Webhook received successfully
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BilledEvent'
components:
  schemas:
    BilledEventEvent:
      type: string
      enum:
        - billed
      title: BilledEventEvent
    BilledEventDataChannel:
      type: string
      enum:
        - sms
        - whatsapp
        - email
      title: BilledEventDataChannel
    BilledEventDataCurrency:
      type: string
      enum:
        - MYR
      title: BilledEventDataCurrency
    BilledEventData:
      type: object
      properties:
        messageUuid:
          type: string
          format: uuid
        broadcastUuid:
          type: string
          format: uuid
        channel:
          $ref: '#/components/schemas/BilledEventDataChannel'
        amountCents:
          type: integer
          description: Cost charged for this single message
        currency:
          $ref: '#/components/schemas/BilledEventDataCurrency'
        balanceAfterCents:
          type: integer
          description: Client balance after this settlement
      required:
        - messageUuid
        - broadcastUuid
        - channel
        - amountCents
        - currency
      title: BilledEventData
    BilledEvent:
      type: object
      properties:
        event:
          $ref: '#/components/schemas/BilledEventEvent'
        timestamp:
          type: string
          format: date-time
        data:
          $ref: '#/components/schemas/BilledEventData'
      required:
        - event
        - timestamp
        - data
      title: BilledEvent

```