Schema Change Notifications in GraphQL Inspector
Tags: graphql, graphqlinspector
Published: 2021-07-29 10:02:43

> This article was published on Monday, May 4, 2020 by [Kamil Kisiela](https://twitter.com/kamilkisiela) @ [The Guild Blog](https://the-guild.dev/)

The new version of GraphQL Inspector comes with **schema change notifications**. We had it in plans
for [almost a year](https://github.com/kamilkisiela/graphql-inspector/issues/214) now and we're very
excited to finally roll it out!

We recently released a lot more interesting features. You can read about them in
["New GraphQL Inspector and upcoming features"](/blog/new-graphql-inspector) article.

## Schema Change Notifications

If you wish to stay up to date with changes happening in your GraphQL API the Notifications are
perfect for you.

We know how hard it is to track and keep up with the development of a GraphQL Schema. Following
every merged Pull Request or every pushed commit is impossible at scale. You don't want to analyze
the code in order to find and understand changes in your GraphQL API.

> We decided to automate and reverse this process so every new change will come to you, not the
> other way around.

GraphQL Inspector tracks every Push in your Git repository and depending on a branch, sends you a
message on Slack or Discord (or custom Webhook) with a list of changes introduced to a GraphQL
schema.

Changes are grouped by their criticality level: Breaking, Dangerous and Safe.

Schema Change Notifications feature works well with any setup,
[even with multiple environments](/blog/multiple-environments-endpoints-graphql-inspector). You're
able to track changes in all variants of your GraphQL API, on production, staging and other
environments.

### Notifications on Slack

To start receiving notifications on Slack you simply provide a url to Slack's Webhook.

```yaml
notifications:
  slack: webhook-url-here
```

That's it.

![Notifications on Slack](https://the-guild.dev/blog-assets/schema-change-notifications/slack.png "Notifications on Slack")

### Notifications on Discord

The configuration process is exactly the same as with Slack. Provide a url to a webhook created in
your Discord workspace.

```yaml
notifications:
  discord: webhook-url-here
```

Enjoy!

![Notifications on Discord](https://the-guild.dev/blog-assets/schema-change-notifications/discord.png "Notifications on Discord")

## Webhook

GraphQL Inspector should not limit you but help and that's why we decided to support not only Slack
and Discord but rather something more universal, like Webhooks.

```yaml
notifications:
  webhook: webhook-url-here
```

You can setup an HTTP endpoint, like serverless function and receive an event, every time there's a
change in GraphQL Schema.

***

## Future Plans

We're working on **Azure** and **Bitbucket** integrations plus a **monitoring** feature. Talk to us
to try it out.

We want to make **Azure** and **Bitbucket** a first-class citizens in GraphQL Inspector and give you
the same experience as you get right now with **GitHub**.

**Monitoring** will enable you to analyze the traffic of your GraphQL APIs and provide details
needed to improve performance. Collecting information about the usage will let you safely remove
deprecated pieces of GraphQL Schema.

> If you're interested, please reach out to us!

***

## Enjoy GraphQL Inspector!

We have big plans for Inspector, and you're very welcome to join us in that journey.

GraphQL Inspector is a tool created by developers, for developers and that's why we'd love to get
your feedback and shape GraphQL Inspector together!

**Oh… and it's [Open-Sourced](https://github.com/kamilkisiela/graphql-inspector)!**