aiagentwithdhruv/add-webhook

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:

   {
     "your-webhook-slug": {
       "directive": "your_directive",
       "description": "What this webhook does",
       "tools": ["send_email", "read_sheet", "update_sheet"]
     }
   }
   

3. Deploy

   modal deploy execution/modal_webhook.py
   

4. Test

   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)