Skip to content

Account Webhooks

Webhooks API to manage account-specific webhooks. You can create, retrieve, update, and delete webhooks programmatically. Account-level webhooks are configured independently for US and EU regions. When triggered, webhook URLs are deduplicated by event type, across account and domain levels to prevent redundant webhook sends.

Operations

List account-level webhooks

Request

Retrieve all account-level webhooks or filter by specific webhook IDs. Returns webhook details including associated event types.

Security
basicAuth
Query
webhook_idsstring

Comma-separated list of webhook IDs to filter results. If specified, only webhooks with matching IDs will be returned.

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v1/webhooks?webhook_ids=string'

Responses

A 200 response

Bodyapplication/json
webhooksArray of objects(github.com-mailgun-domains-httpapi-AccountLevelWebhookView)required
Response
{
  "webhooks": [
    { … },
    { … }
  ]
}