Update Webhook

PUT

/partner/v1/webhooks/{id}

Full-object update: send every field, not just the changed ones.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Validation failed

🟠404Not found

🟠401Unauthorized

🟠403Missing scope / feature

🟠429Rate limited

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/partner/v1/webhooks/' \
--header 'X-Store-Id: {{partner_store_id}}' \
--header 'Accept-Language: en' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://pos.example.com/hooks/yamm",
    "description": "POS returns sync",
    "subscribed_events": [
        "return.created",
        "return.approved"
    ],
    "api_version": "2026-04",
    "is_active": true
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "url": "string",
        "api_version": "string",
        "description": "string",
        "secret": "string",
        "previous_secret_expires_at": "string",
        "subscribed_events": [
            "string"
        ],
        "is_active": true,
        "disabled_reason": "string",
        "created_at": "string",
        "updated_at": "string"
    }
}

Get Webhook

Delete Webhook