> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tela.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Events Overview

> Connect Workstation with any system through real-time notifications

**Events** is Workstation's real-time integration solution that automatically connects your tasks with any external system. Through **webhooks**, you receive instant notifications about important events in your tasks' **lifecycle**, enabling you to build **automated and integrated workflows**.

<CardGroup cols={2}>
  <Card title="Automate Processes" icon="robot">
    Trigger actions in other systems without manual intervention
  </Card>

  <Card title="Integrate Workflows" icon="link">
    Connect Workstation with your existing systems
  </Card>

  <Card title="Monitor in Real-Time" icon="gauge">
    Receive immediate updates about task status
  </Card>

  <Card title="Build Pipelines" icon="diagram-project">
    Create complex workflows across multiple platforms
  </Card>
</CardGroup>

## Available Events

You can choose which events you want to receive notifications for. Select only the events relevant to your workflow to keep your integration focused and efficient.

<AccordionGroup>
  <Accordion title="Tasks Completed" icon="circle-check">
    Triggered when a task run finishes successfully
  </Accordion>

  <Accordion title="Tasks Failed" icon="circle-xmark">
    Triggered when a task run ends with a failure
  </Accordion>

  <Accordion title="Tasks Approved" icon="thumbs-up">
    Triggered when a task is reviewed and approved
  </Accordion>

  <Accordion title="Tasks Approval Revoked" icon="rotate-left">
    Triggered when an approved task returns to validating
  </Accordion>
</AccordionGroup>

## How Does It Work?

The Events system was designed to be simple to configure, yet extremely reliable in production:

### Simple Configuration

<Steps>
  <Step title="Define your endpoint">
    Provide the URL that will receive notifications
  </Step>

  <Step title="Configure authentication">
    Add custom headers to authenticate your requests
  </Step>

  <Step title="Test before activating">
    Validate your configuration with real payloads before going to production
  </Step>
</Steps>

## Two Flexible Approaches

We offer **two flexible ways** to work with webhooks, allowing you to choose the best approach for each use case:

<Tabs>
  <Tab title="Visual Interface">
    ### Permanent Configuration via Interface

    **Ideal for**: Long-term integrations, production environments, multiple teams

    Configure your webhooks visually through the Workstation interface in just a few clicks and receive events automatically:

    * ✅ **Intuitive interface**: Configure everything visually without writing code
    * ✅ **Centralized management**: View and manage all your integrations in one place
    * ✅ **Fixed headers**: Configure authentication tokens and headers that will be sent automatically
    * ✅ **Integrated testing**: Test button allows you to validate your configuration before activating

    <Info>**How to access**: App Settings → "Events" Tab → Enable Events</Info>
  </Tab>

  <Tab title="Dynamic API">
    ### Dynamic Webhooks via API

    **Ideal for**: Multi-tenant SaaS integrations, dynamic endpoints, temporary integrations

    Send notifications to different endpoints with each call, without creating permanent subscriptions:

    * ⚡ **Total flexibility**: Each call can notify a different endpoint
    * ⚡ **Zero prior configuration**: Start using immediately without setup
    * ⚡ **Dynamic headers**: Pass different credentials for each client/context
    * ⚡ **Native multi-tenant**: Perfect for SaaS with multiple clients
    * ⚡ **Temporary webhooks**: Useful for tests, demos, or one-time integrations

    <Info>**How to use**: Add `webhook_url` in your call body + `x-tela-forward-*` headers for authentication</Info>
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={3}>
  <Card title="Configuration" icon="gear" href="/en/workstation/events/configuration">
    Learn how to configure webhooks
  </Card>

  <Card title="Authentication" icon="key" href="/en/workstation/events/authentication">
    Secure your integrations
  </Card>

  <Card title="Payload Reference" icon="file-code" href="/en/workstation/events/payload-reference">
    Understand the webhook payload
  </Card>
</CardGroup>