> 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-promotion.md).

# createPromotion

### Arguments

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

### CreatePromotionInput Arguments

| Argument                                                                                                                                     | Description                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| publicName ([String](/graphql-api/api-reference/objects/string.md))                                                                          | Alternative name to be displayed on invoices and checkout.                                                                                                                                                                                                                                                                         |
| autoApply ([Boolean](/graphql-api/api-reference/objects/boolean.md))                                                                         | Whether or not this promotion will automatically be applied on checkout                                                                                                                                                                                                                                                            |
| deactivationStrategy ([AppliedPromotionDeactivationStrategy](/graphql-api/api-reference/objects/applied-promotion-deactivation-strategy.md)) | Which mechanism will be used to deactivate the promotion                                                                                                                                                                                                                                                                           |
| deactivateAfterAmountIncludingTaxCents ([Int](/graphql-api/api-reference/objects/int.md))                                                    | The amount (in cents) after which the promotion should get deactivated on a customer                                                                                                                                                                                                                                               |
| deactivateAfterTimes ([Int](/graphql-api/api-reference/objects/int.md))                                                                      | After how many times this promotion is "used up" for a customer                                                                                                                                                                                                                                                                    |
| discountType ([PromotionDiscountTypeEnum](/graphql-api/api-reference/objects/promotion-discount-type-enum.md))                               | Which type of the discount will be used.                                                                                                                                                                                                                                                                                           |
| amountCents ([Int](/graphql-api/api-reference/objects/int.md))                                                                               | The amount of discount that this promotion gives.                                                                                                                                                                                                                                                                                  |
| activated ([Boolean](/graphql-api/api-reference/objects/boolean.md))                                                                         | Whether or not this promotion should be active                                                                                                                                                                                                                                                                                     |
| countryOverrides (\[[PromotionCountryOverrideInput](/graphql-api/api-reference/objects/promotion-country-override-input.md)!])               | Country specific setting overrides for this promotion. These will override default promotion settings for specified countries. Add new or update override for existing name/countryCode combination. Note: This feature is currently in beta testing - overrides will only take effect once enabled for your account by Firmhouse. |
| title ([String](/graphql-api/api-reference/objects/string.md)!)                                                                              | The title of the promotion as it will appear on invoices and in the portal.                                                                                                                                                                                                                                                        |
| percentDiscount ([Int](/graphql-api/api-reference/objects/int.md))                                                                           | The percentage of discount that this promotion gives.                                                                                                                                                                                                                                                                              |

### Return fields

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

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