Example: Configure an inbound integration

Inbound integrations take action in xMatters. For example, xMatters might create or terminate a notification alert based on an incoming web request.

In this example, we'll build an inbound integration that sends notifications when New Relic detects a new incident.

1. Add a new Inbound Integration

The first step in getting an integration up and running in xMatters is to create and save the integration in our workflow.

2. Send a test webhook to xMatters

In this next step, we'll get New Relic to send a web request to our integration URL so that we can figure out what our transformation script needs to do.

3. Check the request details in the Activity panel

We can use the Activity panel in xMatters to see the history of incoming web requests sent to us by an integration service. Once we see what New Relic is sending us, we can transform the content so that our form understands it.

4. Transform the content of the incoming request

In this step, we'll create a script that will transform the incoming web request from New Relic into a format that is compatible with our form.

5. Check that it works

The final thing to do is to send another webhook from New Relic and make sure everything is working.

And that's it!