Skip to main content
POST
/
api
/
v2
/
network
/
promo-codes
/
bulk
Bulk create promo codes
curl --request POST \
  --url 'https://{domain}/api/v2/network/promo-codes/bulk?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "promo_codes": [
    {
      "code": "string",
      "affiliate_id": 1,
      "offer_id": 1,
      "start_date": "2025-01-20",
      "end_date": "2025-01-20",
      "description": "Sample description",
      "commission_plan_id": 1
    }
  ]
}
'
{
  "status": "success",
  "code": 200,
  "name": "OK",
  "message": "Bulk create completed",
  "info": {
    "total": 123,
    "created": 123,
    "failed": 123,
    "results": [
      {
        "index": 123,
        "code": "<string>",
        "error": "<string>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.scaleo.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

api-key
string
query
required

API key passed as query parameter. User must have api_status enabled.

Body

application/json
promo_codes
object[]
required

Promo codes to create in the order they should be processed.

Required array length: 1 - 1000 elements

Response

Bulk create result with aggregate counters and per-record statuses.

status
string
Example:

"success"

code
integer
Example:

200

name
string
Example:

"OK"

message
string
Example:

"Bulk create completed"

info
object