add-webhook

---
name: add-webhook
description: Add new Modal webhooks for event-driven execution. Use when user asks to create a webhook, add an endpoint, or set up event triggers.
license: MIT
---

# Add Webhook

## Goal
Create new Modal webhooks for event-driven Claude orchestration.

## Process

1. **Create Directive File**
   Create `directives/your_directive.md` with:
   - Goal
   - Inputs
   - Process steps
   - Outputs
   - Edge cases

2. **Add to webhooks.json**
   Add entry to `execution/webhooks.json`:
   ```json
   {
     "your-webhook-slug": {
       "directive": "your_directive",
       "description": "What this webhook does",
       "tools": ["send_email", "read_sheet", "update_sheet"]
     }
   }
   ```

3. **Deploy**
   ```bash
   modal deploy execution/modal_webhook.py
   ```

4. **Test**
   ```bash
   curl "https://your-modal-username--claude-orchestrator-directive.modal.run?slug=your-webhook-slug"
   ```

## Available Tools for Webhooks
- `send_email`
- `read_sheet`
- `update_sheet`

## Endpoints
- List: `https://your-modal-username--claude-orchestrator-list-webhooks.modal.run`
- Execute: `https://your-modal-username--claude-orchestrator-directive.modal.run?slug={slug}`

---

## Schema

### Inputs
| Name | Type | Required | Description |
|------|------|----------|-------------|
| `slug` | string | Yes | Webhook slug identifier |
| `directive` | string | Yes | Directive file name (without .md) |
| `description` | string | Yes | What this webhook does |
| `tools` | array | Yes | List of tools the webhook can use |

### Outputs
| Name | Type | Description |
|------|------|-------------|
| `webhook_url` | string | Modal webhook URL for execution |

### Credentials
| Name | Source |
|------|--------|
| `MODAL_TOKEN_ID` | Modal dashboard |
| `MODAL_TOKEN_SECRET` | Modal dashboard |

### Composable With
Skills that chain well with this one: `modal-deploy`

### Cost
Modal compute (pay-per-use)