Register Webhook

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"]
}

POST

api

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

string

required

The HTTPS URL to receive webhook 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

integer

Webhook endpoint ID.

string

The registered URL.

string

HMAC-SHA256 signing secret prefixed with whsec_. Shown once — store this securely.

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"]
}

API documentation

Transfers

Webhooks

Integration

Request body

Response

​Request body

​Response

Request body

Response