---
title: "Update Billing Settings"
method: PUT
path: "/api/v1/billing/settings"
tags: ["Billing"]
---

# Update Billing Settings

`PUT /api/v1/billing/settings`

## Request body

- UpdateBillingSettingsRequest
  - `overage_cap_cents` integer, nullable — Monthly SMS+voice overage spend limit in cents. Omit to leave unchanged; null clears the limit; 0 blocks all overage-incurring sends and calls.
  - `remove_branding_footer` boolean, nullable — Set true to remove the 'Sent via Inkbox' footer from outbound emails (paid plans only; 403 on Free). Omit or null to leave unchanged.

## Response `200`

Successful Response

- BillingSettingsResponse
  - `overage_cap_cents` integer, nullable — Monthly SMS+voice overage spend limit in cents; None = no limit. Once cycle-to-date overage spend reaches it, overage-incurring sends and calls are refused (402) until the cycle resets or the limit is raised. Usage within included allowances is never blocked; inbound and in-flight usage can exceed the limit slightly.
  - `remove_branding_footer` boolean — When true and the organization is on a paid plan, outbound emails omit the 'Sent via Inkbox' footer. Takes effect only while the organization is on a paid plan; on the Free plan the footer always applies.

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inkbox/inkbox-api/revisions/31f357e7e6f8/schema)