Features/Webhooks

Webhooks

Form submitted. Agent notified. The human-in-the-loop pipeline.

Updated March 2026

When someone submits a form, Sutrena sends the data to your URL. Slack, Discord, Telegram, Microsoft Teams, Google Chat, Zapier, Make, n8n, or your own backend. Built-in templates auto-format payloads for each platform. HMAC-SHA256 signing so you can verify it came from us. Delivery logs so you can see what happened. The human-in-the-loop workflow: agent creates form, human fills it, agent gets notified.

What it does

  • HTTPS webhooks with HMAC-SHA256 signing for verification
  • Delivery logs — see status codes, response times, success/failure for each delivery
  • Test endpoint — send a ping to verify your webhook is receiving events
  • Built-in templates for Slack, Discord, Telegram, Microsoft Teams, and Google Chat
  • Field mapping — remap field names in the payload (e.g. email → user_email)
  • Link webhooks to specific forms or receive all form submissions
  • Enable/disable webhooks without deleting them
  • Works with Slack, Discord, Telegram, Teams, Google Chat, Zapier, Make, n8n, or any HTTPS endpoint
  • Webhook payload includes all submission fields plus metadata
  • Up to 1 webhook on Free, unlimited on Pro and Scale

How it works

curl -X POST https://sutrena.com/api/webhooks \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.slack.com/services/T.../B.../xxx",
    "description": "New signup alerts",
    "formIds": ["FORM_ID"],
    "fieldMapping": {
      "email": "user_email",
      "name": "user_name"
    }
  }'

# Test it:
curl -X POST https://sutrena.com/api/webhooks/WEBHOOK_ID/test \
  -H "Authorization: Bearer YOUR_KEY"

Create a webhook, link it to a form, test it. When submissions arrive, your endpoint gets called with the data.

What it does not do

Five built-in templates handle platform-specific formatting. For complex event routing or conditional delivery, consider automations -- they handle confirmation emails, conditional branching, and page entries natively without needing an external endpoint. Use Zapier or n8n when you need to connect to services Sutrena doesn't reach directly.

FAQ

How do I verify the webhook came from Sutrena?

Each webhook delivery includes an HMAC-SHA256 signature in the headers. Verify it against your webhook secret to confirm the payload is authentic and has not been tampered with.

Can I see if a webhook delivery failed?

Yes. GET /api/webhooks/:id/deliveries returns the delivery log — status code, response time, success/failure, and the response body for each delivery.

Which platforms have built-in templates?

Slack, Discord, Telegram, Microsoft Teams, and Google Chat. Set the template parameter when creating a webhook and point the URL at the platform's incoming webhook endpoint. Sutrena auto-formats the payload.

How many webhooks can I create?

Free: 1. Pro ($29/mo): unlimited. Scale ($99/mo): unlimited. Each webhook can be linked to multiple forms.

When should I use automations instead of webhooks?

Automations are a good fit when you need confirmation emails, conditional routing based on field values, or page entry creation -- all without an external endpoint. Webhooks are better when you need to push data to an external service like Slack, Discord, or a third-party API with platform-specific formatting and delivery tracking.

What is Sutrena?

Sutrena is the web runtime for AI agents. Forms, Pages, Analytics, Webhooks, Automations — all through 67 MCP tools and one REST API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Use any one feature or all of them together.

Pages

Deploy HTML instantly

Forms

Collect structured data

Automations

DSL-based pipelines with 14 step types

Analytics

Privacy-first, no cookies

Webhooks

Slack, Discord, Telegram

Get started in two API calls

1. Get a trial key (no auth, no signup)

curl -X POST https://sutrena.com/api/trial

2. Create anything — a page, form, automation, or analytics site

# Create a form
curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "waitlist", "fields": [{"name": "email", "label": "Email", "type": "email", "required": true}]}'

# Or deploy a page
curl -X POST https://sutrena.com/api/pages \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"slug": "index", "title": "My Site", "html": "<h1>Live</h1>"}'

Ready to build?

Get a trial API key instantly with no signup, or create an account for the full experience.

Webhooks — Real-Time Form Notifications | Sutrena | Sutrena