Removing stale webhooks
Last updated
Last updated
When you integrate Avion with a backlog tool like Jira, we register a webhook that sends us notifications when your data changes. This is how we keep your story map data up-to-date.
Each story map that has an integration will have its own webhook registered. In the case of GitHub and ZenHub, we create multiple webhooks per story map, generally for each repo.
When you remove an integration, we will always attempt to remove the webhooks so that we don't receive your data any longer. This is very important from a data security perspective because, as far as Avion is concerned, you are no longer permitting us to read your data.
However, there are instances where this removal will not happen. Such as — if your trial expires and you never removed an integration from a story map. In this case, Avion will continue to get updates.
Again, to try and prevent this, we periodically attempt to clean up webhooks that are clearly not required any more. However, occasionally this will also fail. It's possible that we will no longer have the required permissions to remove the webhook. In this case, we highly recommend that you clean up the webhooks manually.
TL;DR — You need to manually remove webhooks that are not required by Avion and can't be automatically removed.
The process is slightly different per service. Here are some guides for each service.
Click on the Settings (cog) → System → Webhooks
Find the webhook that you would like to delete. Remember that every story map has a unique webhook, so don't remove any webhooks for integrations that you want to continue working with
Click Delete
Open the project that your story map is integrated with
Click Project Settings → Service hooks
Locate webhooks for Avion. You can find this by looking at the To host value
Right click Avion webhooks you want to remove (there will be three for each story map)
Click Delete
If your story map was integrated with a single repo, head to Settings → Webhooks and click Delete next to the relevant webhook.
If your story map was integrated with an org, navigate to the org home page and head to Settings → Webhooks and click Delete next to the relevant webhook.
You need to remove a webhook for each repo in the ZenHub workspace in both ZenHub and GitHub. In ZenHub, head to Manage organizations → Slack & Integrations, then click delete on the relevant webhooks.
In GitHub, head to each repo in the ZenHub workspace and head to Settings → Webhooks and click Delete next to the relevant webhook.
Unfortunately, Trello does not provide a UI to manage webhooks, so you need to use their API.
