Webhook Management

Rotate Signing Secret

Replace the endpoint's signing secret. The new secret is returned once and signs every delivery from now on: deploy it to your receiver right away.

POST https://rassmi.com/api/v1/webhooks/{webhook}/rotate-secret

Authorization

Authorizationheaderrequired

Bearer rsk_…: the store's API key, from API Key in your Rassmi dashboard.

Path parameters

webhook string required

The webhook ID.

Responses

Status	Meaning
`200`	Success. The body is shown on the right.
`404`	No such resource in this store.
`401`	Missing, unknown, paused or expired API key.
`429`	More than 60 requests in a minute. See Rate limits.

POST /webhooks/{webhook}/rotate-secret

curl -X POST "https://rassmi.com/api/v1/webhooks/{webhook_id}/rotate-secret" \
  -H "Authorization: Bearer $RASSMI_API_KEY" \
  -H "Accept: application/json"

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('RASSMI_API_KEY'))
    ->acceptJson()
    ->post('https://rassmi.com/api/v1/webhooks/{webhook_id}/rotate-secret');

$data = $response->json();

const response = await fetch('https://rassmi.com/api/v1/webhooks/{webhook_id}/rotate-secret', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.RASSMI_API_KEY}`,
    Accept: 'application/json',
  },
});

const data = await response.json();

import os
import requests

response = requests.request(
    "POST",
    "https://rassmi.com/api/v1/webhooks/{webhook_id}/rotate-secret",
    headers={"Authorization": f"Bearer {os.environ['RASSMI_API_KEY']}"},
)

data = response.json()

Response · 200

{
    "data": {
        "id": "0199a3d0-7c41-7b2e-a0f9-3d2c1b0a9e88",
        "url": "https://example.com/hooks/rassmi",
        "events": [
            "order.created",
            "order.confirmed",
            "order.shipped"
        ],
        "is_active": true,
        "signing_secret_hint": "whsec_k3Pz...",
        "last_triggered_at": "2026-10-30T09:31:05+00:00",
        "created_at": "2026-10-01T10:00:00+00:00"
    },
    "signing_secret": "Zx81Lm0Qp4Rt7Yv2Wn6Bc9Hd3Kf5Js1A"
}