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

organization.project.deleted

Sent when a project is deleted from the organization.

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

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 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

organization.project.environment.deleted

Sent when an environment is deleted from a project.

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.

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.