Upvest · JSON Structure

Investment Api Webhook Subscription Structure

A webhook subscription for receiving event notifications.

Type: object Properties: 5
Banking InfrastructureFintechInvestmentsSecuritiesFractional InvestingCustodyWealth Management

WebhookSubscription is a JSON Structure definition published by Upvest, describing 5 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id url event_categories status created_at

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/upvest/refs/heads/main/json-structure/investment-api-webhook-subscription-structure.json",
  "name": "WebhookSubscription",
  "description": "A webhook subscription for receiving event notifications.",
  "type": "object",
  "properties": {
    "id": {
      "type": "uuid",
      "description": "The webhook subscription identifier.",
      "example": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    },
    "url": {
      "type": "uri",
      "description": "The HTTPS endpoint URL to deliver events to.",
      "example": "https://example.com"
    },
    "event_categories": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ALL",
          "USER",
          "USER_CHECK",
          "ORDER",
          "ORDER_CANCELLATION",
          "EXECUTION",
          "POSITION",
          "CASH_BALANCE",
          "ACCOUNT",
          "ACCOUNT_GROUP",
          "PORTFOLIO",
          "SAVINGS_PLAN",
          "DIRECT_DEBIT",
          "WITHDRAWAL",
          "MANDATE",
          "SECURITIES_TRANSFER",
          "ACCOUNT_TRANSFER",
          "CORPORATE_ACTION",
          "LIQUIDATION",
          "REPORT",
          "FEE",
          "REBALANCING"
        ]
      },
      "description": "The event categories to subscribe to.",
      "example": [
        "ALL"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "INACTIVE"
      ],
      "description": "The subscription status.",
      "example": "ACTIVE"
    },
    "created_at": {
      "type": "datetime",
      "description": "When the subscription was created.",
      "example": "2025-03-15T14:30:00Z"
    }
  }
}