Mokaform

Webhook integration

Send Mokaform submission payloads to your own HTTPS endpoint and process answers, files, metadata, and integrations server-side.

Use webhooks when your own system should receive submission data directly.

Before you connect

  • Prepare an HTTPS endpoint that can receive POST requests.
  • Decide how your server will authenticate or verify incoming events.
  • Make sure your endpoint can respond quickly with a successful status code.
  • Log payloads during testing so you can inspect field names and values.

Configure a webhook

Open the questionnaire and go to the integrations area.

Choose Webhook.

Enter the destination URL.

Configure SSL verification and an optional secret if your setup uses one.

Submit a test response.

Confirm your server receives and accepts the payload.

What to include in your handler

  • Validate the request before trusting the payload.
  • Return a 2xx response only after accepting the event.
  • Store the submission ID so repeated delivery does not create duplicates.
  • Handle missing optional answers.
  • Avoid logging sensitive answers in plain text.

Practical tips

  • Use a staging endpoint before connecting production systems.
  • Keep your handler tolerant of new fields.
  • Transform Mokaform answers into your internal schema after receipt.
  • Monitor failures and rotate secrets when access changes.

Troubleshooting

On this page