Receive organization events at your webhook URL to connect Voiceflow with observability, testing, or automation tools. Voiceflow sends event data when projects or environments are created, changed, or deleted.
Configuring your webhook settings
Open dashboard Settings → Organization and find Organization event webhooks. This is separate from a project’s Settings → Webhooks, which sends session and call events.
- Enter the endpoint in Webhook url, leave the field and wait for Saved.
- Choose Listen for all events or Listen for specific events. Select individual events or a whole category, then wait for Saved. Keep at least one event selected.
- Copy Webhook secret into your receiver’s verification configuration. See Verifying requests come from Voiceflow.
Changing these settings requires organization update access; the form is read-only without it.
Supported events
The following organization-level events will be sent to the provided URL:
organization.project.created
Sent when a new project is created in the organization.
Example organization.project.created payload
Example organization.project.created payload
organization.project.deleted
Sent when a project is deleted from the organization.
Example organization.project.deleted payload
Example organization.project.deleted payload
organization.project.environment.created
Sent when a new environment is created within a project. The source describes the environment the new one was branched from.
Example organization.project.environment.created payload
Example organization.project.environment.created payload
organization.project.environment.published
Sent when an environment within a project is published. publishedVersionIDBefore and publishedVersionIDAfter let you track what changed.
Example payload - publishing the live Main environment
Example payload - publishing the live Main environment
Example payload - publishing a non-live environment
Example payload - publishing a non-live environment
organization.project.environment.merged
Sent when one environment is merged into another. sourceProjectEnvironmentRemoved indicates whether the source environment was deleted as part of the merge.
Example organization.project.environment.merged payload
Example organization.project.environment.merged payload
organization.project.environment.deleted
Sent when an environment is deleted from a project.
Example organization.project.environment.deleted payload
Example organization.project.environment.deleted payload
Verifying requests come from Voiceflow
Copy Webhook secret from Organization event webhooks and use Svix’s signature-verification library to check incoming requests. Verify the original request body before parsing it; changing or reserializing the body changes its signature. The project’s session lifecycle endpoint has its own secret.
To replace the secret, use Regenerate key, then confirm with Yes. Copy the new value to your receiver. The previous secret remains valid for 24 hours after rotation. Choose No to cancel without changing it.
If your receiver restricts incoming IPs, use Svix’s documented source IP addresses. These webhook requests originate from Svix’s delivery infrastructure.