> For the complete documentation index, see [llms.txt](https://developer.firmhouse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.firmhouse.com/graphql-api/api-reference/mutations/add-next-order-only-product.md).

# addNextOrderOnlyProduct

The product is added with quantity 1, which cannot be changed, and a zero customer price, then automatically removed from the subscription after that order is created.

### Arguments

| Argument                                                                                                         | Description                            |
| ---------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| input ([AddNextOrderOnlyProductInput](/graphql-api/api-reference/objects/add-next-order-only-product-input.md)!) | Parameters for AddNextOrderOnlyProduct |

### AddNextOrderOnlyProductInput Arguments

| Argument                                                         | Description                                                         |
| ---------------------------------------------------------------- | ------------------------------------------------------------------- |
| subscriptionId ([ID](/graphql-api/api-reference/objects/id.md)!) | ID of the subscription whose next order should include the product. |
| productId ([ID](/graphql-api/api-reference/objects/id.md)!)      | ID of the product to add as a gift or free one-off add-on.          |

### Return fields

#### errors (\[[ModelValidationError](/graphql-api/api-reference/objects/model-validation-error.md)!]!)

Validation errors that prevented the next-order-only product from being added.

#### orderedProduct ([OrderedProduct](/graphql-api/api-reference/objects/ordered-product.md))

The free ordered product that will be removed after the next order is generated.

#### subscription ([Subscription](/graphql-api/api-reference/objects/subscription.md))

The subscription receiving the next-order-only product.