Rotate Webhook Secret

POST

/partner/v1/webhooks/{id}/rotate-secret

Issue a new signing secret. The old secret keeps signing for 24 hours.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠404Not found

🟠401Unauthorized

🟠403Missing scope / feature

🟠429Rate limited

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/partner/v1/webhooks//rotate-secret' \
--header 'X-Store-Id: {{partner_store_id}}' \
--header 'Accept-Language: en' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "message": "string",
    "data": {
        "new_secret": "string",
        "old_secret_expires_at": "string"
    }
}

Delete Webhook

Send Test Webhook