---
title: "Create enterprise webhook"
method: POST
path: "/api/v2/enterprise/{enterpriseId}/webhooks"
tags: ["Enterprise Webhooks"]
---

# Create enterprise webhook

`POST /api/v2/enterprise/{enterpriseId}/webhooks`

Create a webhook that will fire for any bank account associated with the enterprise.
Must be an organization or enterprise admin to perform this action. To call this
endpoint, you must have the user_manage scope on a short-lived access token created
either in the web app or programmatically using the [Login](/reference/userlogin#/) endpoint.

## Path parameters

- `enterpriseId` string, required

## Request body

- object
  - `type` 'bankAccount' | 'accessToken' | 'policyBalanceChange' | 'reversal' | 'mintOrder', required
  - `url` string, required
  - `label` string

## Response `200`

OK

- EnterpriseWebhookResponse — Webhook response scoped to enterprise webhook types — `coin` is optional.
  - `id` string, required
  - `created` string, date-time, required
  - `url` string, uri, required
  - `version` number, required — 2 for coins running on API v2.
  - `scope` 'wallet' | 'enterprise' | 'organization' | 'safe', required
  - `state` 'active' | 'suspended', required — If 'active', indicates the webhook can trigger and send to the URL. If 'suspended', indicates the webhook can't trigger.
  - `successiveFailedAttempts` number, required
  - `listenToFailureStates` boolean, required — Whether or not to listen to failed transactions on chain.
  - `coin` string — A cryptocurrency or token ticker symbol.
  - `label` string — Label of the new webhook.
  - `walletId` string
  - `enterpriseId` string
  - `organizationId` string
  - `userId` string
  - `type` 'bankAccount' | 'accessToken' | 'policyBalanceChange' | 'reversal' | 'mintOrder'
  - `numConfirmations` number
  - `lastAttempt` string, date-time
  - `failingSince` string, date-time
  - `allToken` boolean
  - `txRequestStates` string[]
  - `txRequestTransactionStates` string[]

## Other responses

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

---

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