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

201

Promotion job created

400

Bad Request