> ## Documentation Index
> Fetch the complete documentation index at: https://autmallc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Trigger Conductor tasks over HTTP and handle GitHub webhook events against the local-first runtime.

Conductor exposes a lightweight HTTP surface for external automation.

## Trigger a task over HTTP

```bash theme={null}
curl -X POST http://localhost:4747/api/webhook/task \
  -H "Content-Type: application/json" \
  -d '{"task":"fix the auth bug","project":"my-app","agent":"claude-code"}'
```

## Endpoint summary

* `POST /api/webhook/task`
* `POST /api/webhook/github`
* `GET /api/webhook/status`
* `GET /api/webhook/health`

## Standalone webhook server

If you only need the webhook listener:

```bash theme={null}
co webhook --port 4748
```

## Security

Use `WEBHOOK_SECRET` for GitHub HMAC verification and keep the listener behind a trusted network path when possible.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.