Typeform Trigger Plugin

Dify trigger plugin that listens for Typeform webhooks. Each submission is forwarded to your workflow with the full response payload so you can automate follow-up actions in real time.

Quick Start

Install the plugin in your Dify workspace and drag the trigger into a workflow.
Choose how you want to connect (manual webhook, Personal Access Token, or OAuth).
Select the Typeform you want to listen to (required for API Key / OAuth modes, optional filter when manual).
Save the workflow and submit a test response in Typeform to confirm events arrive in Dify.

Connection Modes

Manual webhook (copy & paste)

Open your Typeform form → Connect → Webhooks.
Add a new webhook using the Dify endpoint (shown when you add this trigger to a workflow).
(Recommended) Enable “Secret” and paste any random string. Record the same value in the trigger subscription’s Webhook Secret field so the plugin can validate signatures.
Enable the webhook and submit a test response to confirm you receive a .

If you manage webhooks through the Typeform API instead of the UI, set the field when creating or upserting the webhook. Use the same value inside Dify.

Auto-managed webhook via Personal Access Token

In Dify, choose Connect with API Key when configuring the trigger.
Generate a Typeform Personal Access Token with the , , and scopes (Account → Personal tokens).
Paste the token in the trigger configuration. Dify will fetch your forms and display a dynamic dropdown.
Select the form you want to subscribe to. You can optionally override the generated webhook secret.
Dify creates (or updates) the webhook in Typeform and stores the secret for signature validation.

Auto-managed webhook via OAuth 2.0

Create an application in the Typeform Developer Portal and enable the , , , and scopes.
Enter the app’s client ID and client secret in the trigger configuration, then click Connect with OAuth.
Complete the Typeform consent flow. Dify exchanges the code for tokens (and keeps the refresh token so it can renew expired access tokens).
Pick the target form from the dynamic dropdown and optionally override the generated secret.
Dify provisions the webhook in Typeform using your OAuth credentials.

Subscription Parameters

Parameter	When used	Description
	Always optional	Filters to a single form when you manage webhooks manually. In API Key / OAuth modes this field becomes a dynamic dropdown and is required.
	Always optional	Shared secret used to verify the header when you configure the webhook manually.
override	API Key & OAuth	Lets you supply a custom secret instead of letting Dify generate one when it creates the webhook for you.

When Dify creates the webhook on your behalf it stores the generated (or overridden) secret in the subscription so signature validation works automatically.

Event Parameters

: comma-separated pairs matched against .
: comma-separated pairs matched against entries in .

If any filter fails, the event is ignored so your workflow doesn’t trigger.

Supported Events

— fired for every Typeform webhook delivery ().

Payload Shape

The event output schema guarantees:

All additional fields supplied by Typeform are preserved for downstream use (answers, definition, variables, hidden fields, etc.).

Directory Structure

Path	Purpose
	Minimal entrypoint invoked by the Dify plugin runtime.
	Describes plugin metadata, runtime configuration, and versioning.
	Declarative trigger configuration (parameters, credentials, events).
	Trigger implementation handling webhooks, credentials, and API calls.
	Event schema exposed to workflows.
	Icons referenced by the manifest for marketplace presentation.

Troubleshooting

OAuth sign-in fails: confirm the redirect URI matches the one shown in Dify and that the Typeform app grants , , , and .
Form dropdown empty: the access token must include ; regenerate the Personal Access Token or re-authorise via OAuth.
Workflow never triggers: ensure the Typeform webhook shows “Enabled”, the trigger is active in Dify, and the same webhook secret is configured on both sides.
Signature validation errors: rotate the webhook secret in Typeform and paste the new value into Dify (manual mode) or reconnect so Dify can regenerate it (API Key / OAuth).

Typeform