# Inspect, Pause, or Delete an Integration Connection (https://www.shipfox.io/docs/how-to/set-up-work/manage-integration-connections)

Description: Copy an integration connection slug, check its recent events, pause it, or delete it safely.

Use this guide to work with an existing integration connection:

* Inspecting a connection changes nothing.
* While a connection is paused, Shipfox drops its events. It doesn't replay
  them later.
* Deleting a connection can't be undone.

## Before you begin [#before-you-begin]

You need an existing integration connection and permission to manage workspace
integrations. If you do not have a connection, connect one from the
[integrations catalog](https://www.shipfox.io/docs/integrations).

## Copy the integration connection slug [#copy-the-integration-connection-slug]

Open **Settings → Integrations**. Open the integration connection's menu and select **Use
this integration**.

Copy the slug from the trigger example. Use the full value as a trigger
`source`. The same value works as `connection` on a tool step or an agent
integration entry.

## Inspect recent events [#inspect-recent-events]

Open the same menu and select **View recent events**. Shipfox opens the event
journal with that integration connection selected.

Send one safe test event from the provider. Open the new event. Check that:

1. The source equals the copied integration connection slug.
2. The event name matches the provider action.
3. The payload shows the test item you sent.
4. The result shows if a workflow matched.

Use [Troubleshoot event routing](https://www.shipfox.io/docs/how-to/run-and-troubleshoot/event-routing) when
delivery succeeds but no run appears.

## Pause and resume an integration connection [#pause-and-resume-an-integration-connection]

Pause a connection to stop its events for a short time. The integration
connection stays in the workspace.

### Check which runs you will miss

Search your workflow files for the integration connection slug. The pause
affects each workflow you find:

* If the slug is a trigger `source`, the workflow doesn't start.
* If the slug is used for checkout or for a tool, that step fails.

Pause the connection only if none of these workflows handles urgent work.

### Disable the integration connection

Open the integration connection's menu and select **Disable integration**.
Send a safe test event. Check that it does not appear in
**Settings → Events** and that no workflow run starts from it.

### Enable and verify the integration connection

Open the menu again and select **Enable integration**. Send a new test event
from the provider. Check that it appears in the event journal with a final
routing result.

If the fresh event does not arrive, repeat the setup check on the provider's
setup page in the [integrations catalog](https://www.shipfox.io/docs/integrations).

## Delete an integration connection [#delete-an-integration-connection]

Delete a connection only when no project should use its external account or
installation. Set up a replacement first if its events, checkout, or tools must
continue.

### Check every dependency

Search `.shipfox/workflows/` in each project repository for the slug. Check
trigger `source` values, and tool step and agent `connection` values. Open
each project's settings and check whether this is its source integration
connection. Identify active runs whose listening jobs still expect events
from it.

Point workflow files and project settings to a replacement where needed,
then wait for every changed workflow to sync successfully. Do not delete the
connection while a project needs it for checkout or an active listener needs
its events.

### Delete the integration connection

Open the integration connection's menu, select **Delete integration**, and
confirm the workspace and integration connection shown in the dialog.

The action cannot be undone. Shipfox stops receiving its new events. A
workflow that still uses the slug may fail to sync or run.

### Verify the removal

Confirm that the integration connection no longer appears in integration
settings. If it was a custom webhook, confirm that every sender has retired
its old ingest URL. Check the affected projects for sync errors. Start one
workflow through the replacement and check that checkout, events, or tools
still work.

Use [Fix workflow sync](https://www.shipfox.io/docs/how-to/run-and-troubleshoot/workflow-sync) for a
definition that still references the deleted integration connection.