> 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/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/mutations/create-promotion.md).

# createPromotion

Creates a promotion.

### Arguments

| Argument                                                                                                                     | Description                    |
| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| input ([CreatePromotionInput](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/create-promotion-input.md)!) | Parameters for CreatePromotion |

### CreatePromotionInput Arguments

| Argument                                                                                                                                                                    | Description                                                                          |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| publicName ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md))                                                                          | Alternative name to be displayed on invoices and checkout.                           |
| autoApply ([Boolean](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/boolean.md))                                                                         | Whether or not this promotion will automatically be applied on checkout              |
| deactivationStrategy ([AppliedPromotionDeactivationStrategy](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/applied-promotion-deactivation-strategy.md)) | Which mechanism will be used to deactivate the promotion                             |
| deactivateAfterAmountIncludingTaxCents ([Int](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/int.md))                                                    | The amount (in cents) after which the promotion should get deactivated on a customer |
| deactivateAfterTimes ([Int](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/int.md))                                                                      | After how many times this promotion is "used up" for a customer                      |
| activated ([Boolean](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/boolean.md))                                                                         | Whether or not this promotion should be active                                       |
| title ([String](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/string.md)!)                                                                              | The title of the promotion as it will appear on invoices and in the portal.          |
| percentDiscount ([Int](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/int.md))                                                                           | The percentage of discount that this promotion gives.                                |

### Return fields

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

#### promotion ([Promotion](/~/changes/v7t3tfYrVBDkXZZGoQGP/graphql-api/api-reference/objects/promotion.md))