Skip to content

configure_webhook

Add a webhook to a deployment. The webhook fires on every new form submission.

Annotations

AnnotationValue
readOnlyHintfalse
destructiveHintfalse
idempotentHintfalse
openWorldHinttrue

Parameters

NameTypeRequiredDescription
deployment_idstringYesThe deployment to attach the webhook to
urlstringYesThe webhook endpoint URL
type"generic" | "slack"NoPayload format (default: "generic")

Return format

Returns the created webhook details:

Webhook created

ID: wh_xyz789
URL: https://hooks.slack.com/services/T00/B00/xxxx
Type: slack
Deployment: dep_abc123

Example

User prompt:

Send a Slack notification to our #signups channel whenever someone fills out the waitlist

What Claude does:

  1. Calls configure_webhook with the deployment id, the Slack incoming webhook URL, and type: "slack".
  2. Confirms the webhook was created and will fire on every new submission.

Notes

  • Generic webhooks send a POST request with a JSON body containing the submission data and metadata.
  • Slack webhooks format the payload as a Slack message with the form fields displayed as a formatted block. Use a Slack incoming webhook URL from your workspace.
  • You can attach multiple webhooks to a single deployment. Each one fires independently on every submission.
  • To remove a webhook, use delete_webhook. To see all webhooks on a deployment, use list_webhooks.

Deploy forms and sites from AI conversations.