Create a promotion code

post

https://partner-api.monta.com/api/v1/promotion-codes

Required scope: promotion-codes:write
Organization authorization: supported

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

length ≥ 1

Name of the promotion code

code

string

required

^[a-z0-9]+(?:-[a-z0-9]+)*$

Unique code string. Must be lowercase alphanumeric, optionally hyphen-separated (e.g. summer-2025).

description

string | null

Description of the promotion code

amount

double

required

0.1 to 500

Percentage for discount types (max 100), or currency amount for the credit type (max 500).

maxUsesCount

int32 | null

≥ 1

Maximum number of times the code can be used

startAt

date-time | null

When the promotion code becomes active (ISO8601: yyyy-MM-ddTHH:mm:ssZ)

endAt

date-time | null

When the promotion code expires (ISO8601: yyyy-MM-ddTHH:mm:ssZ)

type

string | null

Type of the promotion code

userId

int64 | null

User ID to limit this code to a specific user

maxDiscountAmount

number | null

0.01 to 999999.99

Cap on total discount applied across all uses. Once reached, the code becomes unusable. Omit to set no cap.

selectedTeamIds

array of int64s | null

Team IDs the promotion code is restricted to. Omit or pass an empty array to leave the code unrestricted.

selectedTeamIds

maxChargeUsesCount

int32 | null

1 to 10000

Max charges per driver eligible for the discount after redeeming. Omit to set no limit.

Responses

201Promotion code created

400The request is invalid

401Consumer with provided credentials was not found

403Operator doesn't have access to resource

404Entity with the provided id was not found