Edit, pause or delete an integration
Change an integration's details, pause event reception or delete it along with its events.
On this page
You can change any detail of an integration, pause it so it stops accepting events without losing its configuration, or delete it when you no longer use the system.
Before you start
You need the Administrator role. With another role, the Edit and Delete buttons don't appear and the screen shows Only an administrator can create, edit or delete integrations and manage their webhooks.
Edit an integration
Go to Settings → Integrations.
On the card, press Edit (pencil). Edit integration opens.
Change what you need: Name, Category, Provider, Base URL, Health path, Authentication, What this integration provides or Open an incident automatically for critical events.
Press Save. The button is enabled as long as Name and Provider have text. You'll see Integration updated.
For credentials, see Access credentials. The webhook isn't changed from here: use Rotate or Disable webhook on the card.
Pause or resume
Open Edit integration.
In Status, choose Paused (or Active to resume). Below the field there is a reminder: Paused: the webhook stops accepting events.
Press Save.
Pausing keeps the webhook's URL and secret: when you resume, the external system sends again without changes.
The Error status isn't chosen manually: the platform sets it when a connection test fails. An integration in Error keeps accepting events through the webhook. See Test the connection.
If you press Test on a Paused integration, it stops being paused and its webhook accepts events again. Pause it again after testing.
Delete an integration
On the card, press Delete (trash can).
Read the notice in Delete the integration "…"? and confirm with Yes, delete.
All events received from that integration are also deleted and its webhook is disabled. Incidents already opened from its events and the assets it reported are kept. This action can't be undone.
What happens next
You'll see Integration deleted. and the card disappears. If the Received events tab was filtered by that integration, the filter goes back to All integrations.