---
title: "Create sequence sets"
method: POST
path: "/v1/sequence-sets"
tags: ["Sequence Sets"]
---

# Create sequence sets

`POST /v1/sequence-sets`

Creates sequence sets, allowing distinct numbering sequences for billing documents, payments, and refunds. Billing documents include invoices, credit memos, and debit memos.

You can create a maximum of 100 sequence sets in one single request. A sequence set comprises a set of custom prefixes and starting numbers that are used for billing documents to generate, and payments and refunds to create.

See [Prefix and Numbering Configuration for Billing Documents](https://docs.zuora.com?resourceId=billing-config-of-prefix-and-number-for-billing-docs) for more information about limitations.

**Note**: The Credit and Debit Memos feature is only available if you have [Invoice Settlement](https://docs.zuora.com?resourceId=billing-invoice-settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://docs.zuora.com?resourceId=billing-invoice-settlement-migration-checklist-and-guide) for more information.

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string
- `Zuora-Version` string

## Request body

- POSTSequenceSetsRequest
  - `sequenceSets` POSTSequenceSetRequest[] — Array of sequence sets configured for billing documents, payments, and refunds.
    - `creditMemo` CreditMemoEntityPrefix, required — Container for the prefix and starting document number of credit memos. **Note:** This field is only available if you have the Invoice Settlement feature enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://docs.zuora.com?resourceId=billing-invoice-settlement-migration-checklist-and-guide) for more information.
      - `prefix` string — The prefix of credit memos.
      - `startNumber` integer — The starting document number of credit memos.
    - `debitMemo` DebitMemoEntityPrefix, required — Container for the prefix and starting document number of debit memos. **Note:** This field is only available if you have the Invoice Settlement feature enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://docs.zuora.com?resourceId=billing-invoice-settlement-migration-checklist-and-guide) for more information.
      - `prefix` string — The prefix of debit memos.
      - `startNumber` integer — The starting document number of debit memos.
    - `invoice` InvoiceEntityPrefix, required — Container for the prefix and starting document number of invoices.
      - `prefix` string — The prefix of invoices.
      - `startNumber` integer — The starting document number of invoices.
    - `name` string, required — The name of the sequence set to configure for billing documents, payments, and refunds.
    - `sequenceSetNumber` string — Specifies the sequence set number to assign when creating the sequence set. **Note:** This value is set only during creation and cannot be updated after the sequence set is created.
    - `payment` PaymentEntityPrefix — Container for the prefix and starting number of payments.
      - `prefix` string — The prefix of payments.
      - `startNumber` integer — The starting number of payments.
    - `refund` RefundEntityPrefix — Container for the prefix and starting number of refunds.
      - `prefix` string — The prefix of refunds.
      - `startNumber` integer — The starting number of refunds.

## Response `200`

OK

- POSTSequenceSetsResponse
  - `sequenceSets` GETSequenceSetResponse[] — Array of sequence sets configured for billing documents, payments, and refunds.
    - `creditMemo` CreditMemoEntityPrefix — Container for the prefix and starting document number of credit memos. **Note:** This field is only available if you have the Invoice Settlement feature enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://docs.zuora.com?resourceId=billing-invoice-settlement-migration-checklist-and-guide) for more information.
      - `prefix` string — The prefix of credit memos.
      - `startNumber` integer — The starting document number of credit memos.
    - `debitMemo` DebitMemoEntityPrefix — Container for the prefix and starting document number of debit memos. **Note:** This field is only available if you have the Invoice Settlement feature enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://docs.zuora.com?resourceId=billing-invoice-settlement-migration-checklist-and-guide) for more information.
      - `prefix` string — The prefix of debit memos.
      - `startNumber` integer — The starting document number of debit memos.
    - `id` string — The unique ID of the sequence set. For example, 402892c74c9193cd014c96bbe7c101f9.
    - `invoice` InvoiceEntityPrefix — Container for the prefix and starting document number of invoices.
      - `prefix` string — The prefix of invoices.
      - `startNumber` integer — The starting document number of invoices.
    - `name` string — The name of the sequence set.
    - `payment` PaymentEntityPrefix — Container for the prefix and starting number of payments.
      - `prefix` string — The prefix of payments.
      - `startNumber` integer — The starting number of payments.
    - `refund` RefundEntityPrefix — Container for the prefix and starting number of refunds.
      - `prefix` string — The prefix of refunds.
      - `startNumber` integer — The starting number of refunds.
  - `success` boolean — Indicates whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

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