---
title: "Create an outgoing webhook for an app"
method: POST
path: "/apps/{app-slug}/outgoing-webhooks"
tags: ["outgoing-webhook"]
---

# Create an outgoing webhook for an app

`POST /apps/{app-slug}/outgoing-webhooks`

Create an outgoing webhook for a specified Bitrise app: this can be used to send build events to a specified URL with custom headers. Currently, only build events can trigger outgoing webhooks.

## Path parameters

- `app-slug` string, required

## Request body

- V0AppWebhookCreateParams
  - `events` string[], required
  - `headers` object
  - `secret` string, required
  - `url` string, required

## Response `200`

OK

- V0AppWebhookCreatedResponseModel
  - `data` V0AppWebhookResponseItemModel
    - `created_at` string
    - `events` string[]
    - `headers` object
    - `registered_by_addon` boolean
    - `slug` string
    - `updated_at` string
    - `url` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitrise/apis/bitrise-api.md) · [All operations](https://skmtc.net/bitrise/apis/bitrise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrise/bitrise-api/versions/89468e4a014b/schema)