# Create and Manage Webhooks

Webhooks allow external systems to send data directly into Sprinto.

Each webhook generates a unique endpoint URL that can receive incoming requests from external services.

Webhooks are commonly used when:

* Data must be pushed into Sprinto automatically
* Events occur outside scheduled ingestion plans
* External systems support webhook delivery
* Near real-time processing is required

Within Sprinto, webhooks can be configured with:

* Authentication rules
* Rate limiting
* Attached ingestion plans
* Event filtering
* Runtime parameters
* Event visibility

***

## Before You Begin

Ensure that:

* You have access to the **Ingestion** module
* A webhook use case has been identified
* Any required ingestion plans already exist
* Authentication requirements are known

***

## Access the Webhooks Page

To manage webhooks:

1. Log in to the Sprinto dashboard.
2. Go to **Ingestion**.
3. Select the **Webhooks** tab.

<figure><img src="/files/BnpYqrwVmdRWi6zQ0jQR" alt="" width="563"><figcaption></figcaption></figure>

The Webhooks page displays all configured webhooks.

***

## Understand the Webhooks Dashboard

The Webhooks dashboard lists all available webhooks.

Each row typically includes:

<table><thead><tr><th width="124.21484375">Column</th><th width="216.4765625">Description</th></tr></thead><tbody><tr><td>Name</td><td>Webhook name</td></tr><tr><td>Description</td><td>Optional explanation</td></tr><tr><td>Status</td><td>Current webhook state</td></tr><tr><td>Created At</td><td>Creation timestamp</td></tr><tr><td>Actions</td><td>Opens webhook details</td></tr></tbody></table>

Use the dashboard to monitor existing webhook configurations.

***

## Create a Webhook

Create a webhook when you need Sprinto to receive data from an external source.

### Add a Webhook

1. Open the **Webhooks** tab.
2. Click **New Webhook**.
3. Configure webhook settings.

<figure><img src="/files/JGr3xXJxeCCKLahTN9Td" alt="" width="563"><figcaption></figcaption></figure>

The webhook becomes available immediately.

***

## Configure Webhook Details

Webhook creation includes multiple configuration sections.

***

## Basic Information

Configure:

* Webhook name
* Description

Use descriptive naming to identify the source system.

Examples include:

* Incident Events
* Device Sync Webhook
* Security Alert Feed

<figure><img src="/files/5KK2kY80ROoh0zFSECCC" alt="" width="563"><figcaption></figcaption></figure>

***

## Authentication

Authentication validates incoming requests.

Authentication ensures that only trusted systems can send data.

Authentication configuration may include:

* Secret keys
* Signature validation
* Header mapping
* Token validation

The authentication method depends on the external system.

<figure><img src="/files/X8x2MfuI9qWlDtOqdmgg" alt="" width="563"><figcaption></figcaption></figure>

***

## Advanced Configuration

Advanced settings define how Sprinto processes webhook requests.

Advanced configuration may include:

* Payload handling
* Event identification
* Challenge validation
* Custom parsing rules

These settings help align the webhook with external payload formats.

<figure><img src="/files/HShpsI81cibbwq9zWQOE" alt="" width="563"><figcaption></figcaption></figure>

***

## Rate Limiting

Rate limiting controls how many requests Sprinto accepts.

Rate limiting helps:

* Prevent abuse
* Avoid overload
* Improve webhook stability

Rate limits can be configured during webhook creation or editing.

<figure><img src="/files/Bh2G5lk5nGnIEhoRtbuS" alt="" width="563"><figcaption></figcaption></figure>

***

## Save a Webhook

After configuring all sections:

1. Review the configuration.
2. Click **Save**.

<figure><img src="/files/wWR9J7mFuixh9ci8HyfI" alt="" width="563"><figcaption></figcaption></figure>

Sprinto creates the webhook and generates a webhook URL.

***

## View Webhook Details

Webhook details provide access to configuration and event activity.

### Open Webhook Details

1. Locate a webhook.
2. Click **View**.

<figure><img src="/files/cvG6NVTaRFIx8V0FH1HM" alt="" width="563"><figcaption></figcaption></figure>

Sprinto opens the webhook details page.

***

## Webhook Details Overview

The details page includes:

* Configuration summary
* Webhook URL
* Attached plans
* Recent events
* Testing utilities
* Lifecycle actions

<figure><img src="/files/oTfe2iFwfRB4NVck7dkC" alt="" width="563"><figcaption></figcaption></figure>

***

## View the Webhook URL

Each webhook includes a generated endpoint URL.

External systems must send requests to this endpoint.

The URL is visible from the webhook details page.

***

## Test a Webhook

Webhook testing helps validate connectivity.

Sprinto provides a cURL testing section to help verify requests.

### Test a Webhook

1. Open webhook details.
2. Review the test request example.
3. Send a request to the webhook endpoint.
4. Confirm event visibility.

Testing helps confirm that payloads reach Sprinto successfully.

***

## Attach a Plan to a Webhook

Attached plans determine how webhook payloads are processed.

Without a plan, webhook requests may be received but not processed into ingestion workflows.

### Attach a Plan

1. Open webhook details.
2. Go to **Attached Plans**.
3. Click **Attach Plan**.
4. Select a plan.
5. Configure optional settings.
6. Click **Attach**.

<figure><img src="/files/3tdwexC2X9jcNLuotbdR" alt="" width="563"><figcaption></figcaption></figure>

The plan becomes associated with the webhook.

***

## Configure Attached Plan Settings

When attaching a plan, you can configure additional behaviour.

### Filter Expression

Filter expressions control whether incoming events should trigger processing.

Use filters to:

* Restrict processing
* Ignore unnecessary payloads
* Match specific event types

### Runtime Parameters

Runtime parameters pass values from the payload into the plan.

This allows dynamic execution based on incoming data.

***

## View Recent Events

Recent events display webhook activity.

This helps confirm whether requests are reaching Sprinto.

### Recent Event Information

Each event may include:

<table><thead><tr><th width="142.8671875">Field</th><th width="277.3046875">Description</th></tr></thead><tbody><tr><td>Timestamp</td><td>When the request was received</td></tr><tr><td>Status</td><td>Processing result</td></tr><tr><td>Event ID</td><td>Unique event identifier</td></tr><tr><td>Payload</td><td>Incoming request preview</td></tr></tbody></table>

Recent events are useful for troubleshooting.

***

## Edit a Webhook

Webhook configurations can be updated after creation.

### Edit a Webhook

1. Open webhook details.
2. Click **Edit**.

<figure><img src="/files/Yt8j56KOhoEawezrHAtP" alt="" width="563"><figcaption></figcaption></figure>

3. Update the required configuration.
4. Click **Save** to save the changes.

<figure><img src="/files/SK327WsbMYtPUWYKlNHc" alt="" width="563"><figcaption></figcaption></figure>

Updates apply immediately.

***

## Rotate Webhook ID

Rotating a webhook ID generates a new endpoint URL.

Use rotation when:

* Credentials are compromised
* Endpoint URLs must be refreshed
* Security policies require regeneration

### Rotate a Webhook ID

1. Open webhook details.
2. Click **Rotate ID**.

<figure><img src="/files/5ckLCS4ITYczIfTdgMvQ" alt="" width="563"><figcaption></figcaption></figure>

1. Confirm the action.

Sprinto generates a new webhook URL.

### Important

After rotation:

* Old URLs stop working
* External systems must update the endpoint
* Requests sent to the previous URL fail

***

## Delete a Webhook

Delete a webhook when it is no longer required.

### Delete a Webhook

1. Open webhook details.
2. Click **Delete**.

<figure><img src="/files/cDbBreHWlIrQJFr0lfGC" alt="" width="563"><figcaption></figcaption></figure>

3. Confirm the action.

The webhook is permanently removed.

{% hint style="warning" %}

#### Important

Deleting a webhook:

* Removes the endpoint
* Prevents future requests
* Cannot be undone
  {% endhint %}

***

## Webhook Workflow

A typical webhook lifecycle follows this sequence:

1. Create a webhook.
2. Configure authentication.
3. Define advanced settings.
4. Save the webhook.
5. Share the endpoint URL.
6. Attach a plan.
7. Receive incoming requests.
8. Monitor recent events.
9. Update or rotate configuration when needed.

***

## Best Practices

Use the following recommendations when managing webhooks:

* Use descriptive webhook names
* Configure authentication whenever possible
* Attach plans immediately after creation
* Test webhook delivery before production use
* Use filters to reduce unnecessary processing
* Review recent events regularly
* Rotate webhook IDs if exposure occurs
* Delete unused webhooks

***

### Related Information

* [Create and Configure an Ingestion Plan](/ingestion/dashboard-actions/create-and-configure-an-ingestion-plan.md)
* [Manage Plan Execution and Version History](/ingestion/dashboard-actions/manage-plan-execution-and-version-history.md)
* [Build and Edit Plans Using YAML and AI Editor](/ingestion/dashboard-actions/build-and-edit-plans-using-yaml-and-ai-editor.md)
* [Create and Manage Entity Types](/ingestion/dashboard-actions/create-and-manage-entity-types.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sprinto.com/ingestion/dashboard-actions/create-and-manage-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.