Claude Platform Docs

Unwrap

beta.webhooks.unwrap(payload, headers, key) -> BetaWebhookEvent
Function

Verifies the webhook signature from the webhook-id, webhook-timestamp and webhook-signature headers using your webhook signing key, then parses the payload into an event. Fails if the signature is missing or invalid.

Parameters
payload: str

The body of the incoming webhook request, exactly as received: the signature is computed over these bytes.

headers: Mapping[str, str]

The HTTP headers of the incoming webhook request. Verification reads webhook-id, webhook-timestamp and webhook-signature.

key: Optional[Union[str, bytes]]

The webhook signing key. Defaults to the client's webhook_key option.

Returns
class BetaWebhookEvent: type: "event"; id; created_at; data
type: Literal["event"]

Object type. Always event for webhook payloads.

id: str

Unique event identifier for idempotency.

created_at: datetime

RFC 3339 timestamp when the event occurred.

formatdate-time
data: BetaWebhookEventData
One of the following:
Unwrap
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
# `payload` is the raw body of the incoming webhook request and `headers` are its HTTP headers.
event = client.beta.webhooks.unwrap(
    payload,
    headers=headers,
)
print(event)