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.

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)