Skip to main content
POST
/
v1
/
webhook
/
create-webhook
curl -X POST 'https://crypto-api.yativo.com/api/v1/webhook/create-webhook' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["deposit.detected", "deposit.confirmed", "transaction.failed", "transaction.authorized", "transaction.settled", "customer.funded"],
    "description": "Production webhook"
  }'

{
  "status": true,
  "message": "Webhook created successfully",
  "data": {
    "webhook_id": "68241abc2f3d4e5f6a7b8c9d",
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["deposit.detected", "deposit.confirmed", "transaction.failed", "transaction.authorized", "transaction.settled", "customer.funded"],
    "secret": "whsec_a8f3c2e1d4b7f9e2c5a3b6d8f1e4c7a2b5d8e1f4c7a2b5d8",
    "created_at": "2026-03-28T10:00:00.000Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
url
string
required
The HTTPS URL that will receive webhook POST requests.
​
events
array
Array of event slugs to subscribe to. Pass ["*"] (or omit) to receive all events. Includes both general crypto events and card issuer events. Example slugs:
  • deposit.detected
  • deposit.confirmed
  • transaction.failed
  • card.created
  • transaction.authorized
  • transaction.settled
  • customer.funded
  • master_wallet.deposit
​
description
string
A human-readable name for this webhook.
curl -X POST 'https://crypto-api.yativo.com/api/v1/webhook/create-webhook' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["deposit.detected", "deposit.confirmed", "transaction.failed", "transaction.authorized", "transaction.settled", "customer.funded"],
    "description": "Production webhook"
  }'

{
  "status": true,
  "message": "Webhook created successfully",
  "data": {
    "webhook_id": "68241abc2f3d4e5f6a7b8c9d",
    "url": "https://your-app.com/webhooks/yativo",
    "events": ["deposit.detected", "deposit.confirmed", "transaction.failed", "transaction.authorized", "transaction.settled", "customer.funded"],
    "secret": "whsec_a8f3c2e1d4b7f9e2c5a3b6d8f1e4c7a2b5d8e1f4c7a2b5d8",
    "created_at": "2026-03-28T10:00:00.000Z"
  }
}