Update Advertisement - Salla Merchants APIs

This endpoint allows you to update an existing advertisement post by passing the advertisement_id as a path parameter.

Scopes

marketing.read_write- Marketing Read & Write

curl --location --request PUT 'https://api.salla.dev/admin/v2/advertisements/' \ --header 'Content-Type: application/json' \ --data-raw '{ "title": "Adv Title", "description": "Adv Description", "type": { "name": "product", "id": 1261174103, "link": null }, "expire_date": "2022-12-31", "pages": [ "all" ] }'

{ "status": 200, "success": true, "data": { "id": 1549230938, "title": "Adv Title", "description": "Adv Description", "type": { "id": 1261174103, "name": "product", "link": "https://linkforproduct" }, "style": { "icon": "sicon-bell", "font_color": "#ffffff", "background_color": "#9d8383" }, "expire_date": { "date": "2022-12-12 00:00:00.000000", "timezone_type": 3, "timezone": "Asia/Riyadh" }, "pages": [ "all" ] } }

Request

Authorization

Add the parameter

Authorization

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

Example:

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

Path Params

advertisements_id

string

required

Unique identification number assigned to the Advertisement. List of Advertisement IDs can be found here.

Body Params application/json

title

string

required

Advertisement Title.

Example:

Adv Title

description

string

required

Advertisement Description. 🌐 Support multi-language

Example:

Adv Description

type

object

required

name

enum<string>

optional

Advertisement Type

Allowed values:

categorypageproductofferswithout_urlexternal_link

Example:

product

number

optional

Advertisement ID. The type.id variable is requiredif type.name is any of these values: ["category" , "page" , "product"]

Example:

1261174103

link

string | null

optional

Advertisement Link. The type.link is requiredif type.name is external_link

expire_date

string

required

Advertisement expiry date.

Example:

2022-12-31

pages

array[string]

required

Which pages should the advertisement appear on.

Allowed values:

allcartproductpaymentcategoryhome

Examples

Responses

🟢200Success

application/json

Body

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

object (Advertisement)

optional

number

required

Advertisement ID

title

string

required

Advertisement Title

description

string

required

Advertisement Description. 🌐 Support multi-language

type

object

required

style

object

required

expire_date

object

required

pages

array[string]

required

Which pages should the advertisement appear on

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized