Mintlify Webhooks

Mintlify webhooks let agents respond to documentation build events.

Filter Fields (all optional)

Field	Type	Description
`projects`	string[]	Only trigger for these Mintlify projects
`events`	string[]	Mintlify event types (build, etc.)
`actions`	string[]	Event actions (failed, succeeded, etc.)
`branches`	string[]	Only for these branches

In Mintlify, go to your project settings
Navigate to Webhooks or Integrations
Add a webhook with URL: https://your-server:8080/webhooks/mintlify
Set the secret to match the mintlify_webhook_secret credential instance referenced by the webhook source in config.toml
Select build events you want to receive (build failures, successes, etc.)

# In project config.toml
[webhooks.mintlify-docs]
type = "mintlify"
credential = "docs-project"

# In agents/<name>/config.toml
[[webhooks]]
source = "mintlify-docs"
events = ["build"]
actions = ["failed"]
projects = ["my-docs"]