API
Sign In

Register a New Service Hook

Register a new service hook on a project. 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 project 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 the following scopes:
  • project:write
POST /api/0/projects/{organization_slug}/{project_slug}/hooks/
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://example.com/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://example.com/sentry-hook"
}