Source: https://sprinto-test.docs-staging.pageloop.ai/ingestion/dashboard-actions/create-and-manage-webhooks # 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. ![](/assets/3c00e444db49-screenshot-2026-04-24-at-17.22.51.png) The Webhooks page displays all configured webhooks. --- ## Understand the Webhooks Dashboard The Webhooks dashboard lists all available webhooks. Each row typically includes: | Column | Description | | ----------- | --------------------- | | Name | Webhook name | | Description | Optional explanation | | Status | Current webhook state | | Created At | Creation timestamp | | Actions | Opens webhook details | 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. ![](/assets/37438273cd33-screenshot-2026-04-24-at-17.23.46.png) 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 ![](/assets/48d98e00c087-screenshot-2026-04-24-at-17.25.22.png) --- ## 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. ![](/assets/808ee4354953-screenshot-2026-04-24-at-17.26.04.png) --- ## 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. ![](/assets/2053daa35a62-screenshot-2026-04-24-at-17.26.31.png) --- ## 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. ![](/assets/65317617b1ea-screenshot-2026-04-24-at-17.26.50.png) --- ## Save a Webhook After configuring all sections: 1. Review the configuration. 2. Click **Save**. ![](/assets/f9e55003b21e-screenshot-2026-04-24-at-17.27.24.png) 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**. ![](/assets/3695c8763c01-screenshot-2026-04-24-at-17.27.49.png) 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 ![](/assets/5ef0b74b9aa1-screenshot-2026-04-24-at-17.28.48.png) --- ## 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**. ![](/assets/af6fbed11d46-screenshot-2026-04-24-at-17.29.45.png) 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: | Field | Description | | --------- | ----------------------------- | | Timestamp | When the request was received | | Status | Processing result | | Event ID | Unique event identifier | | Payload | Incoming request preview | 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**. ![](/assets/3f50f76bdb2a-screenshot-2026-04-24-at-17.30.11.png) 3. Update the required configuration. 4. Click **Save** to save the changes. ![](/assets/40339250bdf8-screenshot-2026-04-24-at-17.31.04.png) 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**. ![](/assets/fc7c4b752249-screenshot-2026-04-24-at-17.32.11.png) 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**. ![](/assets/89c2a508bd5b-screenshot-2026-04-24-at-17.33.04.png) 3. Confirm the action. The webhook is permanently removed. > [!WARNING] > > #### Important > > Deleting a webhook: > > - Removes the endpoint > - Prevents future requests > - Cannot be undone --- ## 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) - [Manage Plan Execution and Version History](/ingestion/dashboard-actions/manage-plan-execution-and-version-history) - [Build and Edit Plans Using YAML and AI Editor](/ingestion/dashboard-actions/build-and-edit-plans-using-yaml-and-ai-editor) - [Create and Manage Entity Types](/ingestion/dashboard-actions/create-and-manage-entity-types)