---
title: "adjustment.created"
method: POST
path: "adjustment.created"
tags: ["Adjustments"]
---

# adjustment.created

`POST adjustment.created` (webhook)

Occurs when an adjustment is created.

## Headers

- `paddle_signature` string, required

## Payload

- object
  - `event_id` string, required: Unique Paddle ID for this event, prefixed with `evt_`.
  - `event_type` 'address.created' | 'address.imported' | 'address.updated' | 'adjustment.created' | 'adjustment.updated' | 'api_key.created' | 'api_key.expired' | 'api_key.expiring' | 'api_key.revoked' | 'api_key.updated' | 'api_key_exposure.created' | 'business.created' | 'business.imported' | 'business.updated' | 'client_token.created' | 'client_token.revoked' | 'client_token.updated' | 'customer.created' | 'customer.imported' | 'customer.updated' | 'discount.created' | 'discount.imported' | 'discount.updated' | 'discount_group.created' | 'discount_group.updated' | 'payment_method.saved' | 'payment_method.deleted' | 'payout.created' | 'payout.paid' | 'price.created' | 'price.imported' | 'price.updated' | 'product.created' | 'product.imported' | 'product.updated' | 'report.created' | 'report.updated' | 'subscription.activated' | 'subscription.canceled' | 'subscription.created' | 'subscription.imported' | 'subscription.past_due' | 'subscription.paused' | 'subscription.resumed' | 'subscription.trialing' | 'subscription.updated' | 'transaction.billed' | 'transaction.canceled' | 'transaction.completed' | 'transaction.created' | 'transaction.paid' | 'transaction.past_due' | 'transaction.payment_failed' | 'transaction.ready' | 'transaction.revised' | 'transaction.updated', required: Type of event sent by Paddle, in the format `entity.event_type`.
  - `occurred_at` string, date-time, required: RFC 3339 datetime string of when this event occurred.
  - `notification_id` string, required: Unique Paddle ID for this notification, prefixed with `ntf_`.
  - `data` object, required: New or changed entity.
    - `id` string, required: Reference for the adjustment
    - `action` 'credit' | 'refund' | 'chargeback' | 'chargeback_reverse' | 'chargeback_warning' | 'chargeback_warning_reverse' | 'credit_reverse', required: How this adjustment impacts the related transaction.
    - `type` 'full' | 'partial', nullable, required: Type of adjustment. Use `full` to adjust the grand total for the related transaction. Include an `items` array when creating a `partial` adjustment. If omitted, defaults to `partial`.
    - `transaction_id` string, required: ID of the Transaction that this adjustment belongs to
    - `subscription_id` string, nullable, required: Unique Paddle ID for this subscription entity, prefixed with `sub_`.
    - `customer_id` string, required: ID of the Customer that this Transaction is for
    - `reason` string, required: Some context on why the adjustment is being performed
    - `credit_applied_to_balance` boolean, nullable, required: When the Transaction collection mode is manual and the status is billed, this field is false. If it is true, it indicates that credits have been applied to the customer's balance. Otherwise, the adjustment is used to decrease the total amount of a billed invoice Transaction.
    - `currency_code` 'USD' | 'EUR' | 'GBP' | 'JPY' | 'AUD' | 'CAD' | 'CHF' | 'HKD' | 'SGD' | 'SEK' | 'ARS' | 'BRL' | 'CLP' | 'CNY' | 'COP' | 'CZK' | 'DKK' | 'HUF' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'NOK' | 'NZD' | 'PEN' | 'PLN' | 'RUB' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'VND' | 'ZAR', required: Supported three-letter ISO 4217 currency code.
    - `status` 'pending_approval' | 'approved' | 'rejected' | 'reversed', required: Status for an adjustment. Pending approval is read-only and cannot be set. Approved and Rejected are both final states for an adjustment.
    - `items` object[], required
      - `id` string, required: Unique Paddle ID for this adjustment item, prefixed with `adjitm_`.
      - `item_id` string, required: Paddle ID for the transaction item that this adjustment item relates to, prefixed with `txnitm_`.
      - `type` 'full' | 'partial' | 'tax' | 'proration', required: Type of adjustment for this transaction item. `tax` adjustments are automatically created by Paddle. Include `amount` when creating a `partial` adjustment.
      - `amount` string, nullable, required: Amount adjusted for this transaction item. Required when item `type` is `partial`.
      - `proration` object, nullable, required: How proration was calculated for this item. Populated when a transaction is created from a subscription change, where `proration_billing_mode` was `prorated_immediately` or `prorated_next_billing_period`. Set automatically by Paddle.
        - `rate` string, required: Rate used to calculate proration.
        - `billing_period` object, required: Billing period that proration is based on.
          - `starts_at` string, date-time, required: RFC 3339 datetime string of when this period starts.
          - `ends_at` string, date-time, required: RFC 3339 datetime string of when this period ends.
      - `totals` object, required: Breakdown of the total for an adjustment item.
        - `subtotal` string, required: Amount multiplied by quantity.
        - `tax` string, required: Total tax on the subtotal.
        - `total` string, required: Total after tax.
    - `totals` object, required: Breakdown of the total for an adjustment.
      - `subtotal` string, required: Total before tax. For tax adjustments, the value is 0.
      - `tax` string, required: Total tax on the subtotal.
      - `total` string, required: Total after tax.
      - `fee` string, required: Total fee taken by Paddle for this adjustment.
      - `retained_fee` string: Paddle fees retained for this adjustment.
      - `earnings` string, required: Total earnings. This is the subtotal minus the fee. For tax adjustments, this value is negative, which means a positive effect in the transaction earnings. This is because the fee is originally calculated from the transaction total, so if a tax adjustment is made, then the fee portion of it is returned.
      - `currency_code` 'USD' | 'EUR' | 'GBP' | 'JPY' | 'AUD' | 'CAD' | 'CHF' | 'HKD' | 'SGD' | 'SEK' | 'ARS' | 'BRL' | 'CLP' | 'CNY' | 'COP' | 'CZK' | 'DKK' | 'HUF' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'NOK' | 'NZD' | 'PEN' | 'PLN' | 'RUB' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'VND' | 'ZAR', required: Three-letter ISO 4217 currency code used for this adjustment.
    - `payout_totals` object, nullable, required: Breakdown of how this adjustment affects your payout balance.
      - `subtotal` string, required: Adjustment total before tax and fees.
      - `tax` string, required: Total tax on the adjustment subtotal.
      - `total` string, required: Adjustment total after tax.
      - `fee` string, required: Adjusted Paddle fee.
      - `retained_fee` string, required: Paddle fees retained for this adjustment.
      - `chargeback_fee` object: Chargeback fees incurred for this adjustment. Only returned when the adjustment `action` is `chargeback` or `chargeback_warning`.
        - `amount` string, required: Chargeback fee converted into the payout currency.
        - `original` object, nullable, required: Chargeback fee before conversion to the payout currency. `null` when the chargeback fee is the same as the payout currency.
          - `amount` string, required: Fee amount for this chargeback in the original currency.
          - `currency_code` 'AUD' | 'CAD' | 'EUR' | 'GBP' | 'USD', required: Three-letter ISO 4217 currency code for the original chargeback fee.
      - `earnings` string, required: Adjusted payout earnings. This is the adjustment total plus adjusted fees.
      - `currency_code` 'AUD' | 'CAD' | 'CHF' | 'CNY' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HUF' | 'PLN' | 'SEK' | 'USD' | 'ZAR', required: Three-letter ISO 4217 currency code used for the payout for this transaction. If your primary currency has changed, this reflects the primary currency at the time the transaction was billed.
    - `tax_rates_used` object[], nullable, required
      - `tax_rate` string, required: Rate used to calculate tax for this adjustment.
      - `totals` object, required: Calculated totals for the tax applied to this adjustment.
        - `subtotal` string, required: Total before tax. For tax adjustments, the value is 0.
        - `tax` string, required: Total tax on the subtotal.
        - `total` string, required: Total after tax.
    - `created_at` string, date-time, required: Timestamp following the RFC 3339 standard. This is set by the system, and cannot be changed via the API.
    - `updated_at` string, date-time, required: Timestamp following the RFC 3339 standard. This is set by the system, and cannot be changed via the API.

## Acknowledgement `200`

Respond with an HTTP 200 status code within 5 seconds to let Paddle know that you successfully received the message.

If your server sends another kind of status code or doesn't respond, Paddle automatically retries using an exponential backoff schedule.

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)