Sending Events to Slack

Using Shift's webhook support, you can send the events that occur in Shift to your team in Slack.

First, create a new incoming webhook integration in Slack. You'll be asked to choose a channel to receive the incoming webhooks.

After you choose a channel, Slack will give you a unique webhook URL. You will use this URL to configure Shift.

Now you can create the outgoing webhook in Shift. In this example, we'll send a notification to Slack every time a new project is created.

curl --request POST \
  --url https://api.shift.io/v3/webhooks \
  --header 'content-type: application/json' \
  --header 'x-key: YOUR_API_KEY' \
  --header 'x-secret: YOUR_API_SECRET'
  --data '{"body":"New project [%entity.project.name%] was created","eventBinding":"project.create","filter":{},"transport":"slack","transportProperties":{"endpoint":"https://hooks.slack.com/services/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","icon_url":"https://info.shift.io/hubfs/images/shift-name-logo-hs-large.png","attachment":"{\"text\":\"[%entity.project.description%]\",\"fallback\":\"[%entity.project.description%]\"}"}}'

That's it. You will receive a notification in Slack whenever a new project is created in Shift.

📘

A closer look at the request body

Here are a few things to note in the example request above:

  • The "endpoint" property is the URL that we got from Slack when we created the incoming webhook.

  • The "body" property allows you to set the message that is displayed in your Slack channel. In this case, the "entity" is the project entity. Take a look at the project endpoint to see all the project entity properties available to you. If this webhook were bound to the asset.create event, all the asset properties would be available when you create the message sent to Slack.

  • The event binding is set to "project create." There are several events you can bind to. Check out Creating a Custom Webhook to learn more about event bindings.

  • You can set the icon URL. This will determine the avatar used when posting messages in Slack.


What’s Next
Did this page help you?