Register Webhook - Salla Merchants APIs

This endpoint allows you to register a new webhook.

Note

The webhook used is to notify/update/delete an external service when an event has occurred.

To trigger your webhook to send data, you can choose one event from the List Events endpoint.

Information

Read more on Webhooks here.

Alert

• New subscriptions with the same URL will update events / restore old webhooks (if they exist).
• The added URL must accept POST requests.
• By default, all new webhooks are registered as version 2. To use version 1, specify it in your request parameters.

Scopes

webhooks.read_write- Webhooks Read & Write

curl --location --request POST 'https://api.salla.dev/admin/v2/webhooks/subscribe' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "Salla Update Customer Event", "event": "customer.updated", "url": "https://webhook.site/07254470-c763-4ee3-bef1-ab2480262814", "version": 2, "rule": "payment_method = mada OR price < 50", "headers": [ { "key": "Your Secret token key name", "value": "Your Secret token value" } ] }'

{ "status": 200, "success": true, "data": { "id": 60587520, "name": "Salla Update Customer Event", "event": "customer.updated", "type": "manual", "url": "https://webhook.site/07254470-c763-4ee3-bef1-ab2480262814", "version": 2, "rule": "payment_method = mada OR price < 50", "headers": { "Authorization": "abcd1234", "Accept-Language": "AR" } } }

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

name

string

optional

Webhook name. List of Webhook names can be found here.

Example:

Salla Update Customer Event

event

string

required

Webhook event. List of events can be found here, you can use one from the list.

Example:

customer.updated

url

string

required

Webhook URL.

Example:

https://webhook.site/07254470-c763-4ee3-bef1-ab2480262814

version

enum<integer>

optional

Version of the webhook; either valued as 1 or 2.

Allowed values:

Example:

rule

string

optional

Operations, expressions and conditions to your webhook. For example, you may use =,!=,AND,OR etc in such a menner: payment_method = YOUR_PAYMENT_METHOD or in combination company_id = 871291 OR price < 50. That adds more capbility to filter the response based on conditions

Example:

payment_method = mada OR price < 50

headers

array [object {2}]

optional

Webhook headers.

key

string

optional

Any header key, which its value is sent in the post request to the webhook URL

Example:

Your Secret token key name

value

string

optional

The value sent to the webhook; for example: cf-ray: 669af54ecf55dfcb-FRA

Example:

Your Secret token value

Examples

Responses

🟢200New webhook has been registered successfully

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 (Webhook)

optional

number

required

A unique identifier assigned to a webhook.

Example:

60587520

name

string

required

The designated label assigned to a webhook.

Example:

Salla Update Customer Event

event

string

required

An event that triggers a webhook to send real-time data between applications (from the events list).

Example:

customer.updated

type

string

required

Webhook type.

url

string

required

The address where a webhook sends data when a predefined event occurs.

Example:

https://webhook.site/07254470-c763-4ee3-bef1-ab2480262814

version

enum<number>

required

The webhook version, with values of 1 or 2, reflecting changes or updates to its functionality or structure.

Allowed values:

Example:

rule

string

required

operations, expressions, and conditions to your webhook, like =, !=, AND, or OR. For example: payment_method = YOUR_PAYMENT_METHOD , payment_method = mada OR price < 50
This enables precise response filtering based on your criteria.

Example:

payment_method = mada

headers

object

required

Details included in webhook requests, such as authentication and content metadata, ensure secure and accurate communication between web services. These are represented by headers.key and headers.value.

🟠422Error Validation

🟠401Unauthorized