Skip to main content
POST
/
v1
/
webhooks
Create webhook endpoint
curl --request POST \
  --url https://api.daimo.com/v1/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/webhooks/daimo",
  "events": [
    "session.succeeded"
  ],
  "description": "<string>"
}
'
{
  "webhook": {
    "id": "<string>",
    "url": "<string>",
    "events": [
      "session.succeeded"
    ],
    "description": "<string>",
    "secret": "<string>",
    "createdAt": 1700000000
  }
}

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token

Body

application/json
​
url
string<uri>
required

HTTPS URL that will receive POST requests

Example:

"https://example.com/webhooks/daimo"

​
events
enum<string>[]

Event types to subscribe to. Defaults to ["*"].

Webhook event type (or * for all events)

Available options:
*,
session.processing,
session.succeeded,
session.bounced
​
description
string

Human-readable label for this endpoint

Response

Webhook endpoint created

​
webhook
object
required