---
title: "Create a Subscription Balance Entry"
method: POST
path: "/subscriptions/{subscription_id}/subscription_balance_entries"
tags: ["Subscriptions"]
---

# Create a Subscription Balance Entry

`POST /subscriptions/{subscription_id}/subscription_balance_entries`

Create a `Subscription Balance Entry`. A `Subscription Balance Entry` represents a credit applied to a `Subscription`.

## Headers

- `Finix-Version` string
- `Content-Type` string

## Request body

- CreateSubscriptionBalanceEntry
  - `amount` integer — The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).
  - `currency` 'USD' — ISO 4217 3-letter currency code. Currently, the only `currency` supported is `USD`.
  - `description` string — A description of the reason for the subscription credit. Does not support special characters.
  - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`)
  - `type` 'CREDIT', required — Will always be `CREDIT`.

## Response `201`

A single Subscription Balance Entry

- SubscriptionBalanceEntry
  - `id` string — The ID of the resource.
  - `created_at` string, date-time — Timestamp of when the object was created.
  - `updated_at` string, date-time — Timestamp of when the object was last updated.
  - `amount` integer — The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).
  - `currency` 'USD' — ISO 4217 3-letter currency code. Currently, the only `currency` supported is `USD`.
  - `description` string — Describes the circumstances for the subscription credit.
  - `subscription_id` string — The `Subscription` that was credited.
  - `type` string — The value of this field will always be `CREDIT`.
  - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`)

## Other responses

- `400` — Bad Request. The server cannot process the request due to malformed syntax or invalid data.
- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.

---

[API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/5426f6f99c52/schema)