Skip to main content
POST
/
api
/
v1
/
webhooks
curl -X POST /api/v1/webhooks \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/multihopper",
    "events": ["transfer.completed", "transfer.failed"]
  }'

{
  "id": 1,
  "url": "https://your-app.com/webhooks/multihopper",
  "secret": "whsec_abc123...",
  "events": ["transfer.completed", "transfer.failed"]
}
Registers a webhook endpoint. Returns a signing secret — store it securely, it is only shown once.

​
Request body

​
url
string
required
The HTTPS URL to receive webhook events.
​
events
array
List of event types to subscribe to. Defaults to all events if omitted.Available events:
  • transfer.quote_created
  • transfer.deposit_confirmed
  • transfer.processing
  • transfer.hop_complete
  • transfer.completed
  • transfer.failed
  • transfer.expired
  • transfer.refunded
  • payout.completed

​
Response

​
id
integer
Webhook endpoint ID.
​
url
string
The registered URL.
​
secret
string
HMAC-SHA256 signing secret prefixed with whsec_. Shown once — store this securely.
​
events
array
Subscribed event types.
curl -X POST /api/v1/webhooks \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/multihopper",
    "events": ["transfer.completed", "transfer.failed"]
  }'

{
  "id": 1,
  "url": "https://your-app.com/webhooks/multihopper",
  "secret": "whsec_abc123...",
  "events": ["transfer.completed", "transfer.failed"]
}