Manual 06: Integrations And Webhooks
What This Guide Is For
Use this guide to connect external systems and send App events to other tools.
Integrations Versus Webhooks
- Integration: a saved connection to a product such as Google Sheets, Intercom, Canvas, or another service.
- Webhook: a URL that receives event data when something happens, such as a form submission.
Step 1: Connect An Integration
- Go to
Integrations. - Select
Add integration. - Choose the provider.
- Complete the provider login or credential form.
- Save.
Expected result: the integration appears as connected.
Step 2: Use An Integration In An App
- Open an App.
- Go to
Integrations. - Choose the connected integration.
- Configure what data should be sent.
- Save and preview.
Expected result: the App can use the integration during runtime or after submission.
Step 3: Create A Webhook
- Open an App.
- Go to
Webhooks. - Select
Add webhook. - Enter the destination URL.
- Choose events such as submission created or App completed.
- Save.
Expected result: webhook delivery is enabled for selected events.
Step 4: Test A Webhook
- Select the webhook.
- Choose
Send test. - Check the destination system.
- Review delivery logs.
Expected result: the destination receives a signed test event.
Step 5: Review Delivery Logs
Webhook logs should show:
- event type;
- delivery status;
- timestamp;
- response code;
- retry status;
- redacted payload preview.
Troubleshooting
- If an integration fails, reconnect it or check permissions.
- If a webhook fails, check the destination URL and response status.
- If the destination receives duplicates, check idempotency handling.
- If sensitive fields appear in logs, treat it as a security issue.
Product Decisions Needed
- Final list of supported integrations.
- Whether webhooks are configured per App, workspace, or both.
- How webhook signing secrets are shown or rotated.