---
title: "Create billing schedule payment settings"
method: POST
path: "/payments/settings/billing-schedules"
tags: ["Billing Schedules"]
---

# Create billing schedule payment settings

`POST /payments/settings/billing-schedules`

Create payment settings for billing schedules. Invoices for billing schedules with payment settings contain payment links. If payment details are on file with Stripe or other payment providers, then payments are automatically collected when you finalise and send an invoice. Billing schedule payment settings override customer payment settings. You can also override billing schedule payment settings with invoice payment settings.

## Headers

- `Authorization` string, required
- `Sequence-Version` '2024-07-30'

## Request body

- CreateBillingScheduleSettingsEndpointCreateBillingScheduleSettingsRequestModel
  - `billingScheduleId` string, required — Unique payment provider ID.
  - `paymentProvider` 'STRIPE' | 'GOCARDLESS' | 'NONE', required
  - `autoCharge` boolean, nullable — Automatically collect this payment if payment details are available

## Response `201`

Created

- BillingScheduleSettings
  - `id` string, required — Unique payment provider ID.
  - `sequenceAccountId` string, required — Unique Sequence Account ID.
  - `billingScheduleId` string, required — Unique payment provider ID.
  - `paymentProvider` 'STRIPE' | 'GOCARDLESS' | 'NONE', required
  - `autoCharge` boolean, required — Automatically collect payments if payment details are available

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/sequencehq/apis/sequence.md) · [All operations](https://skmtc.net/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequencehq/sequence/versions/cae64b02699f/schema)