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, Zapier, Make, n8n, or your own backend. 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
  • 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, Zapier, Make, n8n, or any HTTPS endpoint
  • Webhook payload includes all submission fields plus metadata
  • Up to 1 webhook on free, 5 on Builder, 10 on Pro, unlimited on 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

No retry logic on failed deliveries right now. No transformation beyond field mapping. If you need complex event routing or conditional delivery, use Zapier or n8n as the webhook target and handle the logic there.

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.

Can I send webhooks to Slack?

Yes. Create a webhook with your Slack incoming webhook URL. Every form submission gets posted to your Slack channel. Use field mapping to customize the payload shape.

How many webhooks can I create?

Free: 1. Builder ($9/mo): 5. Pro ($29/mo): 10. Scale ($79/mo): unlimited. Each webhook can be linked to multiple forms.

What is Sutrena?

Sutrena is the web runtime for AI agents. Three primitives — pages, forms, and dashboards — accessible through one API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Framework-agnostic. Works from any MCP client or HTTP client.

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 a form + dashboard from a template

curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"templateId": "waitlist", "createDashboard": true}'

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