External Events allows you to configure a webhook that sends real-time HTTP requests to your systems whenever a viewer interacts with a SEEN player. This is useful for triggering downstream workflows, analytics pipelines, CRM updates, or any other system that needs to react to viewer activity.
Navigate to Settings → External Events to configure your workspace webhook.
Use the Enabled toggle at the top of the form to activate or deactivate the webhook. When disabled, no requests will be sent regardless of the configuration below.
All configuration fields below are only accessible when the webhook is enabled.
Select the HTTP method to use for the outgoing request. Supported methods: GET POST PUT PATCH
The URL of the endpoint that will receive the webhook request.
Select one or more events that should trigger the webhook. A request will be sent each time one of the selected events occurs.
| Event | Description |
|---|---|
video-played |
Fired when the video starts playing from the beginning. Resuming a paused video does not trigger this event. It will fire again if the player is reloaded and playback is started fresh. |
video-watched |
Fired when a viewer has watched at least 80% of the video. |
player-opened |
Fired when the SEEN player is opened or loaded by the viewer, regardless of whether playback starts. |
share-clicked |
Fired when the viewer clicks the share button inside the player. |
cta-clicked |
Fired when the viewer clicks a Call-to-Action element within the player. |
Add custom HTTP headers to the webhook request as key-value pairs. Click Add Header to add a new row. Remove a header using the trash icon next to it.
A Content-Type: application/json header is included by default.
Expand the Authentication section to configure how the webhook request is authenticated.
If you have already added authentication credentials manually in the Headers section, you can leave this set to None.