# Create an account-level webhook

Create account-level webhook URLs to receive Mailgun's POST requests containing event information across all domains in your account. Note: Webhook changes can take up to 10 minutes to become effective due to caching.

Endpoint: POST /v1/webhooks
Version: 3.0.0
Security: basicAuth

## Request fields (multipart/form-data):

  - `description` (string)
    Description for the webhook

  - `event_types` (string, required)
    Event types to subscribe to. Use multiple times to specify multiple event types. Maximum of 3 unique URLs per event type.
    Enum: "accepted", "clicked", "opened", "unsubscribed", "delivered", "permanent_fail", "temporary_fail", "complained"

  - `url` (string, required)
    URL for webhook to be sent to

## Response 200 fields (application/json):

  - `webhook_id` (string, required)
    Unique identifier for the webhook

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message

## Response 403 fields (application/json):

  - `message` (string, required)
    Response message

## Response 404 fields (application/json):

  - `Description` (string, required)

## Response 409 fields (application/json):

  - `Description` (string, required)