Register a New Service Hook

POST /api/0/projects/{organization_slug}/{project_slug}/hooks/

Register a new service hook on a

projectRepresents your service in Sentry and allows you to scope events to a distinct application.
.

Events include:

  • event.alert: An alert is generated for an event (via rules).
  • event.created: A new event has been processed.

This endpoint requires the 'servicehooks' feature to be enabled for your project.

Path Parameters

organization_slug (string)
REQUIRED

The slug of the organization the client keys belong to.

project_slug (string)
REQUIRED

The slug of the

projectRepresents your service in Sentry and allows you to scope events to a distinct application.
the client keys belong to.

Body Parameters

url (string)
REQUIRED

The URL for the webhook.

events (array)
REQUIRED

The events to subscribe to.

Scopes

<auth_token> requires one of the following scopes:
  • project:write
curl https://sentry.io/api/0/projects/{organization_slug}/{project_slug}/hooks/ \
 -H 'Authorization: Bearer <auth_token>' \
 -H 'Content-Type: application/json' \
 -d '{"url":"https://empowerplant.io/sentry-hook","events":["event.alert","event.created"]}'
RESPONSESCHEMA
{
  "dateCreated": "2018-11-06T21:20:08.143Z",
  "events": [
    "event.alert",
    "event.created"
  ],
  "id": "4f9d73e63b7144ecb8944c41620a090b",
  "secret": "8fcac28aaa4c4f5fa572b61d40a8e084364db25fd37449c299e5a41c0504cbc2",
  "status": "active",
  "url": "https://empowerplant.io/sentry-hook"
}