# Webhook Management

> Webhook CRUD, event types, testing, delivery logs, statistics, and toggle. Use when setting up webhooks for order/payment notifications or debugging webhook delivery.

- Skill: `agents-store/webhook-management-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agents-store/webhook-management-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agents-store/webhook-management-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: agents-store (https://skillmd.com/u/agents-store)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agents-store/webhook-management-2

---


# Webhook Management

This skill covers all webhook operations — creating webhooks for event notifications, testing delivery, viewing logs and statistics, and managing webhook lifecycle.

## Available Tools

| Tool | Description |
|------|-------------|
| `list_webhooks` | List all configured webhooks |
| `get_webhook_events` | Get available webhook event types |
| `get_webhook` | Get single webhook details |
| `create_webhook` | Create a new webhook endpoint |
| `update_webhook` | Update webhook URL, events, or settings |
| `delete_webhook` | Delete a webhook |
| `test_webhook` | Send a test event to a webhook |
| `get_webhook_sample_payload` | Get sample payload for an event type |
| `get_webhook_logs` | Get webhook delivery logs |
| `get_webhook_secret` | Get webhook signing secret for verification |
| `get_webhook_stats` | Get webhook delivery statistics |
| `toggle_webhook` | Enable or disable a webhook |

## Discovering Available Events

```
Tool: get_webhook_events
Input: {}

Returns list of available event types (e.g., order.created, order.updated,
payment.completed, etc.)
```

## Creating Webhooks

### Create Webhook for Order Events
```
Tool: create_webhook
Input: {
  "url": "https://your-server.com/webhooks/teleshop",
  "events": ["order.created", "order.updated"]
}
```

### Step-by-Step Webhook Setup
```
1. get_webhook_events() -> See all available event types
2. create_webhook(url, events) -> Create webhook
3. get_webhook_secret(id) -> Get signing secret for payload verification
4. test_webhook(id) -> Send test event to verify delivery
5. get_webhook_logs(id) -> Check delivery status
```

## Managing Webhooks

### List All Webhooks
```
Tool: list_webhooks
Input: {}
```

### Get Webhook Details
```
Tool: get_webhook
Input: {"id": 1}
```

### Update Webhook
```
Tool: update_webhook
Input: {
  "id": 1,
  "url": "https://new-server.com/webhooks",
  "events": ["order.created", "order.updated", "payment.completed"]
}
```

### Enable/Disable Webhook
```
Tool: toggle_webhook
Input: {"id": 1}

Toggles between enabled and disabled state.
```

### Delete Webhook
```
Tool: delete_webhook
Input: {"id": 1}
```

## Testing and Debugging

### Send Test Event
```
Tool: test_webhook
Input: {"id": 1}

Sends a test payload to the webhook URL to verify it's receiving events correctly.
```

### Get Sample Payload
```
Tool: get_webhook_sample_payload
Input: {"event": "order.created"}

Returns example payload structure for the specified event type.
Useful for building webhook handlers before going live.
```

### View Delivery Logs
```
Tool: get_webhook_logs
Input: {"id": 1}

Returns delivery history with: timestamps, HTTP status codes,
response times, success/failure status.
```

### View Delivery Statistics
```
Tool: get_webhook_stats
Input: {"id": 1}

Returns aggregate stats: total deliveries, success rate,
average response time, failure count.
```

## Webhook Security

### Get Signing Secret
```
Tool: get_webhook_secret
Input: {"id": 1}

Returns the HMAC signing secret for this webhook.
Use this to verify incoming webhook payloads are authentic.
```

## Common Workflows

### Set Up Order Notification Webhook
```
1. get_webhook_events() -> List available events
2. create_webhook(url="https://...", events=["order.created"]) -> Create
3. get_webhook_secret(id) -> Save secret for verification
4. test_webhook(id) -> Verify delivery works
5. get_webhook_logs(id) -> Confirm test was received
```

### Debug Failing Webhook
```
1. list_webhooks() -> Find the webhook
2. get_webhook_stats(id) -> Check success/failure rates
3. get_webhook_logs(id) -> Find failed deliveries and error codes
4. test_webhook(id) -> Test with fresh request
5. If URL changed: update_webhook(id, url="https://new-url.com")
```

### Temporarily Disable Webhook
```
1. toggle_webhook(id) -> Disable
2. ... (do maintenance) ...
3. toggle_webhook(id) -> Re-enable
4. test_webhook(id) -> Verify it's working again
```

### Preview Webhook Payloads
```
1. get_webhook_events() -> List events
2. get_webhook_sample_payload(event="order.created") -> See payload format
3. get_webhook_sample_payload(event="payment.completed") -> See another
```

## Best Practices

1. **Always get signing secret** and verify payloads in your webhook handler
2. **Test webhook** after creation to ensure your endpoint is reachable
3. **Check logs** regularly for delivery failures
4. **Use toggle** instead of delete when temporarily disabling
5. **Subscribe only to needed events** to reduce unnecessary traffic
6. **Review sample payloads** before building webhook handlers
7. **Monitor stats** to catch delivery degradation early