> 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/apply-promotion-to-subscription.md).

# applyPromotionToSubscription

Applies a promotion to a subscription.

### Arguments

| Argument                                                                                                                                                 | Description                                 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| input ([ApplyPromotionToSubscriptionInput](https://developer.firmhouse.com/graphql-api/api-reference/objects/apply-promotion-to-subscription-input.md)!) | Parameters for ApplyPromotionToSubscription |

### ApplyPromotionToSubscriptionInput Arguments

| Argument                                                                                                    | Description                                           |
| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| promotionId ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id.md)!)                | ID of the promotion to apply.                         |
| subscriptionId ([ID](https://developer.firmhouse.com/graphql-api/api-reference/objects/id.md)!)             | ID of the subscription to apply the promotion to.     |
| validatePromotion ([Boolean](https://developer.firmhouse.com/graphql-api/api-reference/objects/boolean.md)) | Whether to validate the promotion before applying it. |

### Return fields

#### appliedPromotion ([AppliedPromotion](https://developer.firmhouse.com/graphql-api/api-reference/objects/applied-promotion.md))

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