curl --request POST \
  --url https://api.mageloyalty.com/v1/webhook-subscriptions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://example.com/webhooks/mage",
  "events": ["points.earned", "customer.tier_upgrade"],
  "description": "Production points + tier sync"
}'

const response = await fetch("https://api.mageloyalty.com/v1/webhook-subscriptions", {
  method: "POST",
  headers: {
    Authorization: "<api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://example.com/webhooks/mage",
    events: ["points.earned", "customer.tier_upgrade"],
    description: "Production points + tier sync",
  }),
});

const data = await response.json();

import requests

response = requests.post(
    "https://api.mageloyalty.com/v1/webhook-subscriptions",
    headers={"Authorization": "<api-key>"},
    json={
        "url": "https://example.com/webhooks/mage",
        "events": ["points.earned", "customer.tier_upgrade"],
        "description": "Production points + tier sync",
    },
)

data = response.json()

<?php
$ch = curl_init("https://api.mageloyalty.com/v1/webhook-subscriptions");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: <api-key>",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "url" => "https://example.com/webhooks/mage",
        "events" => ["points.earned", "customer.tier_upgrade"],
        "description" => "Production points + tier sync",
    ]),
]);
$data = json_decode(curl_exec($ch), true);

{
  "data": {
    "type": "webhook_subscription",
    "id": "whsub_abc123",
    "attributes": {
      "url": "https://example.com/webhooks/mage",
      "events": ["points.earned", "customer.tier_upgrade"],
      "is_active": true,
      "description": "Production points + tier sync",
      "secret": "9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a",
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z"
    }
  }
}

{
  "errors": [
    {
      "status": "400",
      "title": "Bad Request",
      "detail": "url is required"
    }
  ]
}

{
  "errors": [
    {
      "status": "400",
      "title": "Bad Request",
      "detail": "url must be a valid URL"
    }
  ]
}

{
  "errors": [
    {
      "status": "400",
      "title": "Bad Request",
      "detail": "events must be a non-empty array"
    }
  ]
}

{
  "errors": [
    {
      "status": "400",
      "title": "Bad Request",
      "detail": "Invalid event(s): points.created. Valid events: points.earned, points.redeemed, customer.tier_upgrade, customer.tier_downgrade"
    }
  ]
}