Webhooks
This guide shows how webhooks work in Contentful.
Introduction
Webhooks in Contentful help by responding to events such as "an entry was edited", and "an asset has been published/unpublished".
Whenever an event like this occurs, you can set up a webhook that will call a specified URI to somehow react. For instance, you can send a notification to a Slack channel every time someone edits an entry to be notified of changes.
Webhooks greatly extend the integration possibilities provided by Contentful.
Setup
Go to Settings → Webhooks from the navigation bar at the top. Click Add webhook, enter the credentials of the remote host and configure whatever else is necessary in your environment, and you're done.
![webhook new webhook](http://images.contentful.com/fo9twyrwpveg/1Gn2WOuwG42K6A08gwY0Ai/9db3f0b8ad770f33fc86a778915eafdf/webhook__new_webhook.png)
Creating new webhook
Note: You can fine-tune the events which call a webhook.
![webhook events](http://images.contentful.com/fo9twyrwpveg/488gvUzJoQ4GIKggqOQO4K/89c8b0ceac64178cc9676f17bf90e26c/webhook__events.png)
Select when the webhook should be triggered
Note: The "Save" webhook is triggered when the entry (or an asset) has been saved with an API call, and "Autosave" is triggered when it's autosaved in the UI.*
For specific details on what's included in the HTTP request, please refer to the API reference.
Overview
You can find all the webhooks you've created in the main Webhooks screen.
![webhook list of webhooks](http://images.contentful.com/fo9twyrwpveg/4yHjcApbaEKiSKAusSWMi6/851a13753124cc9c21e16b8394b8dbb7/webhook__list_of_webhooks.png)
Note: There's a per-space limit of 20 webhooks.
Activity log
To help you see how the webhooks are doing and make sure that they work as expected, Contentful shows the status of every webhook call in the activity log. Click on a webhook, and the activity log will appear.
![webhook activity log](http://images.contentful.com/fo9twyrwpveg/OJSwxatFAceAqOQgC42GO/4a4a33cebda5f4b7384da6c8b63b6252/webhook__activity_log.png)
See how your requests are doing
To see the request details (including the complete JSON) and the remote server response, click View details.
![webhook request details super secret](http://images.contentful.com/fo9twyrwpveg/5DArLijukoIwKi8Eo2IsCk/6d3882075a84a221c7b6fea9313bda45/webhook__request_details__super_secret.png)
Investigate the details
Further reading
Read our API documentation for specific implementation details.