> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateSalesSubscriptionCommandRequestInput

> Creates a subscription with its line items in one step: everything or nothing. At least one recurring line item (item, custom or voucher) is required. - Request



**Kind**: `input`

## Fields

**`clientId`**: `String`

A temporary identifier chosen by the client, for example to match the answer to an optimistic update. It is not stored and is returned unchanged.

---

**`customerId`**: `ID!` (required)

The ID of the customer.

---

**`companyId`**: `ID!` (required)

The ID of the company that sells.

---

**`number`**: `String`

The subscription number, at most 50 characters. Defaults to the next number of the company's number range for subscriptions.

---

**`currencyCode`**: `String`

The currency as ISO 4217 code. Defaults to the currency of the customer.

---

**`externalNumber`**: `String`

A number from another system, at most 50 characters.

---

**`responsibleUserId`**: `ID`

The user responsible for the subscription.

---

**`languageTag`**: `String`

The language of the documents as BCP 47 language tag, for example de or de-AT. Language subtag in lower case, region subtag in upper case; case does not matter on input. Wawi currently holds only the two-letter language subtag.

---

**`paymentMethodId`**: `ID`

The ID of the payment method.

---

**`shippingMethodId`**: `ID`

The ID of the shipping method.

---

**`processStatusId`**: `ID`

The ID of the process status; it must be usable for subscriptions.

---

**`paymentTerms`**: `SalesSubscriptionPaymentTermsInput`

The payment terms.

---

**`billingAddress`**: `SalesSubscriptionAddressInput`

The billing address. Defaults to the address of the customer.

---

**`shipmentAddress`**: `SalesSubscriptionAddressInput`

The shipping address. Defaults to the address of the customer.

---

**`note`**: `String`

An internal note.

---

**`customerComment`**: `String`

A comment from the customer.

---

**`itemLineItems`**: `[SalesSubscriptionItemLineItemInput]`

Line items for items of the catalog.

---

**`customLineItems`**: `[SalesSubscriptionCustomLineItemInput]`

Free line items.

---

**`voucherLineItems`**: `[SalesSubscriptionVoucherLineItemInput]`

Voucher line items.

---

**`chargeLineItems`**: `[SalesSubscriptionChargeLineItemInput]`

Charges that are part of every follow-up sales order.

---

**`discountLineItems`**: `[SalesSubscriptionDiscountLineItemInput]`

Discounts that are part of every follow-up sales order.

---

**`idempotencyKey`**: `String`

Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.