MOmonta
Promotion Codes

Redeem a promotion code

Changed on

Required scope: promotion-codes:write </br>Organization authorization: supported

post/api/v1/promotion-codes/redeem

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/promotion-codes/redeem
  • Auth
    HTTP bearer

Request body

promotionCodeIdinteger required

Promotion code id

userIdinteger required

Id of the user redeeming the code

teamIdinteger nullable

Id of the team (if applicable)

Example request

{
  "promotionCodeId": 1,
  "userId": 123,
  "teamId": 456
}

Response

Promotion code redeemed

promotionCodeIdinteger required

Id of the promotion code

userIdinteger required

Id of user using the promotion code

status'active' | 'scheduled' | 'expired' | 'inactive' | 'used' | 'other' required

Changes

  • 0ca400461c52Revision changes
    • warning

      added the new other enum value to the //// response property for the response status

    • warning

      added the new used enum value to the //// response property for the response status