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

# Configuration

> Learn how to configure webhooks via interface or API

## Configuration Methods

Workstation offers **two flexible ways** to configure webhooks, each optimized for different use cases:

<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

    ### How to Configure

    <Frame>
      <video controls autoplay loop muted playsinline width="100%" aria-label="How to configure webhook events in Workstation">
        <source src="https://mintcdn.com/meistrari/pblu7JGV78zF0-_0/images/guides/workstation/webhook-events.mp4?fit=max&auto=format&n=pblu7JGV78zF0-_0&q=85&s=7acb76fd3dfce139c0255ae77c7c0262" type="video/mp4" data-path="images/guides/workstation/webhook-events.mp4" />

        Your browser does not support the video tag.
      </video>
    </Frame>

    <Steps>
      <Step title="Access settings">
        Access the app settings in Workstation
      </Step>

      <Step title="Navigate to Events">
        Access the "Events" tab
      </Step>

      <Step title="Enable Events">
        Enable Events in the app
      </Step>

      <Step title="Fill in the details">
        * **URL**: Your endpoint that will receive notifications
        * **Headers**: Add custom headers
      </Step>

      <Step title="Test">
        Click "Test Request" to validate your configuration
      </Step>

      <Step title="Save">
        Save and start receiving notifications!
      </Step>
    </Steps>
  </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

    ### How to Use

    Simply add `webhook_url` to your API request body and use `x-tela-forward-*` headers for authentication:

    ```bash theme={null}
    curl -X POST https://api.tela.com/v1/tasks \
      -H "Content-Type: application/json" \
      -H "x-tela-forward-authorization: Bearer client-123-token" \
      -H "x-tela-forward-custom-id: request-xyz" \
      -d '{
        "webhook_url": "https://example.com/webhook",
        "prompt": "Analyze this document",
        "files": []
      }'
    ```

    **When the task completes**, the webhook will be sent to `https://example.com/webhook` with:

    * Header `authorization: Bearer client-123-token`
    * Header `custom-id: request-xyz`
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/en/workstation/events/authentication">
    Learn about custom headers
  </Card>

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