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

Creates one single-use credit code per string in codes, for handing a credit to a large group of drivers as one code each rather than a shared code. You choose the codes, so they can follow your own naming scheme. Up to 5000 per request; issue a larger run as several requests.

• The response carries the id of every code created. GET /promotion-codes?codePrefix= lists a batch again if the codes share a prefix.
• Retrying is safe. A replayed request finds every code already taken, so it creates nothing new and returns them all in skippedExistingCodes.
• Codes are unique across all operators. One already taken is reported in skippedExistingCodes rather than failing the whole batch, so check that list and reissue those codes under new strings.
• Set startAt in the future to issue the batch inactive, then activate a code with PATCH /promotion-codes/{id} when it is sold. Until then it cannot be redeemed.
• credit must be enabled for your operator, otherwise the request is rejected with 422.
• Your operator wallet is debited as each code is redeemed, not when the batch is created.