Skip to content

Register a bulk promo code definition status update job

Request

Submit an asynchronous job to activate or archive multiple promo code definitions.

You can:

  • Activate draft codes to make them live (the system generates the codes).
  • Archive active codes to retire them. You cannot supply custom codes here, use the single activation endpoint for that.

You will receive a job ID to check the progress of your update.

Security
ZephrHmacHttp
Bodyapplication/jsonrequired
promo_code_definition_updatesArray of objects, [ 1 .. 50 ] items(batch-promo-code-definition-status-update-item)required

The status changes you want to apply. You must include at least 1 change and can include up to 50 changes in a single request.

{ "promo_code_definition_updates": [ { … }, { … } ] }

Responses

Accepted. Your status update is being processed.

Headers
any
Bodyapplication/json
job_idstring, (uuid)required

A unique identifier you can use to check the progress of your status-update job.

messagestringrequired

Your job acceptance confirmation.

Example:"Accepted"
Response
{ "job_id": "7b07e5e2-8eb8-4c10-a85f-529c0b3385b6", "message": "Accepted" }