Create Affiliate

Production

https://api.salla.dev/admin/v2

POST

/affiliates

Last modified:2025-11-12 14:33:01

This endpoint allows you to create a marketing affiliate.

Deprecation Notice

Starting November 01, 2025, this endpoint’s response will be updated, and the old response body will be deprecated.
To avoid breaking changes, update your integration to use the new schema, which supports the new Salla affiliate system.
If the Merchant is still using the old Salla affiliate system, the endpoint will still depend on deprecated payloads.
See the ChangeLog for more details.

Scopes

marketing.read_write- Marketing Read & Write

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

NewOld

{
    "title": "Affiliate name",
    "status": "active",
    "type": "public",
    "apply_to": "first_order",
    "commission": {
        "type": "percent",
        "value": 20,
        "minimum_apply": null
    },
    "discount": {
        "type": "percent",
        "value": 20
    },
    "scopes": {
        "type": "store"
    },
    "start_date": "2024-09-27",
    "end_date": "2024-07-29"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

NewOld

curl --location --request POST 'https://api.salla.dev/admin/v2/affiliates' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "Affiliate name",
    "status": "active",
    "type": "public",
    "apply_to": "first_order",
    "commission": {
        "type": "percent",
        "value": 20,
        "minimum_apply": null
    },
    "discount": {
        "type": "percent",
        "value": 20
    },
    "scopes": {
        "type": "store"
    },
    "start_date": "2024-09-27",
    "end_date": "2024-07-29"
}'

Responses

🟢200Default Response

application/json

Body

Example

{
    "status": 200,
    "success": true,
    "data": {
        "id": 611208326,
        "title": "Affiliate Test",
        "type": "public",
        "apply_to": "first_order",
        "commission": {
            "type": "fix",
            "value": 20,
            "minimum_apply": 80
        },
        "discount": {
            "type": "percent",
            "value": "10"
        },
        "scopes": {
            "id": 1,
            "type": "product"
        },
        "start_date": "",
        "end_date": "",
        "status": "",
        "hide_total_stats": false,
        "statistics": {
            "visits": 17,
            "sales": {
                "amount": 300,
                "currency": "SAR"
            },
            "profit": {
                "amount": 150,
                "currency": "SAR"
            },
            "orders_count": 9
        }
    }
}

🟢200Deprecated Response

🟠422Error Validation

🟠401Unauthorized

Modified at 2025-11-12 14:33:01

List Affiliate Links

Update Affiliate