---
title: "Recurring top-up created"
method: POST
path: "balancePlatform.balanceAccount.recurringTopUp.created"
tags: ["Recurring top ups"]
---

# Recurring top-up created

`POST balancePlatform.balanceAccount.recurringTopUp.created` (webhook)

Adyen sends this webhook when a [recurring top-up](https://docs.adyen.com/api-explorer/balanceplatform/latest/post/balanceAccounts/_balanceAccountId_/recurringTopUps) is successfully created for a balance account.

## Payload

- TopUpConfigurationEventRequest
  - `data` TopUpWebhookData, required
    - `accountId` string, required — The unique identifier of the balance account for which the recurring top-up is configured.
    - `balancePlatform` string — The unique identifier of the balance platform.
    - `creationDate` string, date-time — The date and time when the event was triggered, in ISO 8601 extended format. For example, **2025-03-19T10:15:30+01:00**.
    - `id` string — The ID of the resource.
    - `webhookTopUpConfiguration` WebhookTopUpConfiguration, required
      - `counterparty` WebhookTopUpCounterparty, required
        - `transferInstrumentId` string — The unique identifier of the transfer instrument that is the source of the funds.
      - `description` string, required — The message that is used in the top-up transfer's description body with a maximum length of 140 characters. If the message is longer after replacing placeholders, the message is cut off at 140 characters.
      - `id` string, required — The unique identifier of the recurring top-up configuration.
      - `mandate` WebhookTopUpMandate
        - `creationDate` string, date-time — The date when the mandate was created, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
        - `reference` string — The unique identifier of the mandate.
      - `referenceForBeneficiary` string — A reference that is sent to the recipient. This reference is also sent in all webhooks related to the transfer, so you can use it to track statuses for both parties involved in the funds movement. Supported characters: **a-z**, **A-Z**, **0-9**.
      - `status` 'active' | 'inactive', required — The status of the top-up configuration. Possible values: * **active**: the top-up is enabled and funds are pulled in. * **inactive**: the top-up is disabled and cannot be triggered.
      - `topUpAmount` WebhookTopUpAmount, required
        - `fixedAmount` WebhookAmount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `targetAmount` WebhookAmount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
      - `trigger` WebhookTopUpTrigger, required
        - `schedule` 'monthly' | 'weekdays' | 'weekly' — The schedule for recurring top-ups. Defines when the top-up should be triggered based on time. Possible values: * **weekly**: triggers the top-up once per week. * **monthly**: triggers the top-up once per month. * **weekdays**: triggers the top-up on weekdays only.
        - `threshold` WebhookAmount
          - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
          - `value` integer, required — The amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
  - `environment` string, required — The environment from which the webhook originated. Possible values: **test**, **live**.
  - `timestamp` string, date-time — When the event was queued.
  - `type` 'balancePlatform.balanceAccount.recurringTopUp.created' | 'balancePlatform.balanceAccount.recurringTopUp.deleted', required — Type of webhook.

## Acknowledgement `200`

OK - the request has succeeded.

- BalancePlatformNotificationResponse
  - `notificationResponse` string — Respond with any **2xx** HTTP status code to [accept the webhook](https://docs.adyen.com/development-resources/webhooks/#accept-webhooks).

---

[API](https://skmtc.dev/adyen/apis/configuration-webhooks.md) · [All operations](https://skmtc.dev/adyen/apis/configuration-webhooks/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/configuration-webhooks/revisions/74e0766552b1/schema)