Skip to main content
POST
/
triggers
Create Trigger
curl --request POST \
  --url https://xbt-mainnet.gomaestro-api.org/v0/eventmanager/triggers \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "chain": "bitcoin",
  "network": "mainnet",
  "type": "transaction",
  "webhook_url": "<string>",
  "filters": [
    {
      "key": "sender",
      "operator": "=",
      "value": "<string>"
    }
  ],
  "confirmations": 123
}
'
{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "chain": "bitcoin",
    "network": "mainnet",
    "type": "transaction",
    "webhook_url": "<string>",
    "filters": [
      {
        "key": "sender",
        "operator": "=",
        "value": "<string>"
      }
    ],
    "status": "active",
    "event_count": 123,
    "confirmations": 123
  }
}

Authorizations

​
api-key
string
header
required

Body

application/json
​
name
string
​
chain
enum<string>

Blockchain to listen on (bitcoin)

Available options:
bitcoin
Example:

"bitcoin"

​
network
enum<string>

Network environment to listen on (mainnet)

Available options:
mainnet,
testnet
Example:

"mainnet"

​
type
enum<string>

Trigger type, e.g., transaction

Available options:
transaction
Example:

"transaction"

​
webhook_url
string<uri>

Webhook URL to receive events

Example:

"https://webhook.site/your-endpoint"

​
filters
Filter · object[]
​
confirmations
integer<int32>

Number of confirmations required for the transaction to be matched by this trigger

Example:

"5"

Response

Success

​
data
data · object