> 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/create-free-order-line.md).

# createFreeOrderLine

Adds a free order line to an existing order. Only scheduled orders can be updated; other statuses will cause the mutation

### Arguments

| Argument                                                                                                                               | Description                        |
| -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| input ([CreateFreeOrderLineInput](https://developer.firmhouse.com/graphql-api/api-reference/objects/create-free-order-line-input.md)!) | Parameters for CreateFreeOrderLine |

### CreateFreeOrderLineInput Arguments

| Argument                                                                                                 | Description                                                                                                 |
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| orderId ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id.md)!)                 | ID of the order to add a line to.                                                                           |
| productId ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id.md))                | The ID of the product for this order line.                                                                  |
| shopifyVariantId ([String](https://developer.firmhouse.com/graphql-api/api-reference/objects/string.md)) | The Shopify variant ID to look up the product. Either product\_id or shopify\_variant\_id must be provided. |
| quantity ([Int](https://developer.firmhouse.com/graphql-api/api-reference/objects/int.md)!)              | The quantity of products for this order line.                                                               |

### Return fields

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

#### orderLine ([OrderLine](https://developer.firmhouse.com/graphql-api/api-reference/objects/order-line.md))
