Vapi Trigger icon

Vapi Trigger

Starts the workflow when Vapi sends a webhook event

Vapi Trigger

AI-generated

Summary

Listen for specified Vapi webhook event types and trigger the workflow when matching events are received.

Inputs

  • Event Types (required) — Select one or more Vapi event types to accept; use All Events ('*') to trigger on every event type.
  • Verify Shared Secret Header — Enable to require a specific shared secret header value for accepting incoming webhook requests.
  • Header Name — Specify the HTTP header name that carries the shared secret for verification when enabled; defaults to 'x-vapi-secret'.
  • Expected Value — Define the expected secret value to verify against the incoming request's header to authorize webhook calls.

Output shape

a list of items where each item is the JSON payload of the received Vapi webhook event with an added 'type' field indicating the event type.

If verification of the shared secret header is enabled and fails, the workflow does not trigger and a 401 Unauthorized response is sent. Events not matching the selected types are ignored without triggering the workflow, but the webhook responds 200 OK to acknowledge receipt.

Examples

Example 1: Trigger a workflow on all Vapi events without secret verification.

Set Event Types to 'All Events' and leave Verify Shared Secret Header disabled.

Example 2: Trigger a workflow only on 'chat.created' and 'call.deleted' events with shared secret verification.

Select these events in Event Types, enable Verify Shared Secret Header, set Header Name if different from default, and enter the Expected Value matching the secret.

Links

Discussion