# Subscription Webhook Events

Listen to subscription events to keep your integration always synchronized.

Webhooks are the safest and most reliable way to stay updated in real time.  
Your application will receive a notification whenever the status of a subscription changes.

## Subscription Events
- subscription.created — Subscription created.
- subscription.updated — Subscription updated.
- subscription.activated — Subscription activated.
- subscription.canceled — Subscription canceled.
- subscription.deactivated — Subscription deactivated.
- subscription.expired — Subscription expired.
- subscription.inactivated — Subscription inactivated.

Endpoint: POST Subscription Event
Version: 1.0

## Request fields (application/json):

  - `event` (string)
    Name of the event received.
    Enum: "subscription.created", "subscription.updated", "subscription.activated", "subscription.canceled", "subscription.deactivated", "subscription.expired", "subscription.inactivated"

  - `data` (object)
    Complete subscription data.

  - `data.id` (string)

  - `data.name` (string)

  - `data.createdAt` (string)

  - `data.expiration` (string)

  - `data.installments` (integer)

  - `data.numberRecurrences` (integer)

  - `data.repeatIndefinitely` (boolean)

  - `data.periodicity` (string)
    Enum: "Monthly", "Quarterly", "Biannualy", "Annualy"

  - `data.status` (string)
    Enum: "active", "inactive", "canceled", "expired"

  - `data.paymentMethod` (string)
    Enum: "credit-card", "pix", "bank-billet", "crypto", "debit-card"

  - `data.recurrencePaymentStatus` (string)
    Enum: "pending", "failed", "delayed", "paid", "canceled"

  - `data.recurrenceValueInCents` (integer)

  - `data.customValue` (object)

  - `data.customValue.recurrenceFrom` (integer)

  - `data.customValue.recurrenceTo` (integer)

  - `data.customValue.valueInCents` (integer)

  - `data.retry` (object)

  - `data.retry.intervalInDays` (integer)

  - `data.retry.retriesMaxNumber` (integer)

  - `data.customer` (object)

  - `data.customer.email` (string)

  - `data.customer.phone` (object)

  - `data.customer.phone.ddd` (string)

  - `data.customer.phone.number` (string)

  - `data.customer.phone.areaCode` (string)

  - `data.customer.phone.isMobile` (boolean)

  - `data.customer.document` (object)

  - `data.customer.document.type` (string)

  - `data.customer.deliveryAddress` (object)

  - `data.customer.deliveryAddress.street` (string)

  - `data.customer.deliveryAddress.neighborhood` (string)

  - `data.customer.deliveryAddress.city` (string)

  - `data.customer.deliveryAddress.state` (string)

  - `data.customer.deliveryAddress.zipCode` (string)

  - `data.customer.deliveryAddress.complement` (string)

  - `data.customer.billingAddress` (object)

  - `data.participants` (array)

  - `data.participants.business` (object)