Skip to main content

Create a Rule Promotion Job

POST 
/v2/rule-promotions/:uuid/jobs

Creates an asynchronous job for a specific Rule Promotion. Jobs are used to generate or export promotion codes in bulk.

The following job types are supported:

  • code_generate: Generates a batch of unique promotion codes.
  • code_export: Exports all existing promotion codes as a downloadable CSV file.

Job processing occurs asynchronously. The job request is queued, and its status must be checked separately.

Job Processing Status​

Jobs can have the following statuses:

  • pending: Job is in the queue, waiting to be processed.
  • processing: Job is actively being processed.
  • completed: Job completed successfully.
  • failed: Job encountered an error and did not complete.
  • cancelling: Cancellation in progress (for long-running jobs).
  • cancelled: Job was successfully cancelled.

Please refer to the OpenAPI examples section on this page for sample job creation requests.

Request​

Responses​

Promotion job created