Skip to content

Domain Webhooks

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

Operations

Get domain webhooks

Request

Returns all webhooks for the domain.

Security
basicAuth
Path
domainstringrequired

Domain name you want webhooks for

curl -i -X GET \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/domains/{domain}/webhooks'

Responses

A 200 response

Bodyapplication/json
webhooksobject(github.com-mailgun-domains-httpapi-WebhooksResponse)required

List of webhooks

Response
{
  "webhooks": {
    "accepted": { … },
    "delivered": { … },
    "opened": { … },
    "clicked": { … },
    "unsubscribed": { … },
    "complained": { … },
    "temporary_fail": { … },
    "permanent_fail": { … }
  }
}