Stripe Subscriptions API supports invoice description, footer, and custom_fields

Introduced 2026-06-24 · score 0.99

HOW TO USE IT

When setting details on subscription-generated invoices, set `invoice_settings.description`, `invoice_settings.footer`, and `invoice_settings.custom_fields` when creating or updating a Subscription; retrieve the Subscription to read them.

curl https://api.stripe.com/v1/subscriptions \
  -u "<YOUR_SECRET_KEY>" \
  -H "Stripe-Version: 2026-06-24.dahlia" \
  -d "customer=<CUSTOMER_ID>" \
  -d "items[0][price]=<PRICE_ID>" \
  -d "invoice_settings[description]=<DESCRIPTION>" \
  -d "invoice_settings[footer]=<FOOTER>" \
  -d "invoice_settings[custom_fields][0][name]=<FIELD_NAME>" \
  -d "invoice_settings[custom_fields][0][value]=<FIELD_VALUE>"

curl https://api.stripe.com/v1/subscriptions/<SUBSCRIPTION_ID> \
  -u "<YOUR_SECRET_KEY>" \
  -H "Stripe-Version: 2026-06-24.dahlia" \
  -d "invoice_settings[description]=<DESCRIPTION>" \
  -d "invoice_settings[footer]=<FOOTER>" \
  -d "invoice_settings[custom_fields][0][name]=<FIELD_NAME>" \
  -d "invoice_settings[custom_fields][0][value]=<FIELD_VALUE>"

curl https://api.stripe.com/v1/subscriptions/<SUBSCRIPTION_ID> \
  -u "<YOUR_SECRET_KEY>" \
  -H "Stripe-Version: 2026-06-24.dahlia"

WHY THIS HELPS

Set invoice details for every invoice generated by a subscription when implementing or maintaining subscription billing.

BEFORE THIS CHANGE

These fields were configurable exclusively in the Stripe Dashboard.

REQUIREMENTS AND LIMITATIONS

invoice_settings: Optional settings applied to all invoices for the subscription.
invoice_settings.description: Added as a Subscription invoice_settings parameter; the reference details were not available in the opened documentation.
invoice_settings.footer: Added as a Subscription invoice_settings parameter; the reference details were not available in the opened documentation.
invoice_settings.custom_fields: Added as a Subscription invoice_settings parameter; the reference details were not available in the opened documentation.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card

Tools change faster than your agent’s training data.

Changes

Stripe Subscriptions API supports invoice description, footer, and custom_fields