Update Affiliate

Production

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

PUT

/affiliates/{affiliates_id}

Last modified:2026-07-02 11:20:56

This endpoint allows you to update details regarding an affiliate by passing the affiliate_id as a path parameter.

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 ********************

Path Params

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 PUT 'https://api.salla.dev/admin/v2/affiliates/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "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

Bodyapplication/json

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

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized

Modified at 2026-07-02 11:20:56

List Affiliate Links

Delete Affiliate