Skip to main content
The current 0xkey release supports ACTIVITY_UPDATES only. Balance and transaction webhook subscriptions are not enabled yet.
​
type
enum<string>
required
Enum options: ACTIVITY_TYPE_CREATE_WEBHOOK_ENDPOINT
​
timestampMs
string
required
Timestamp in milliseconds. Used to verify request liveness.
​
organizationId
string
required
Unique identifier for the organization.
​
parameters
object
required

The webhook endpoint creation intent.

​
activity
object
required
Completed activity containing createWebhookEndpointResult.
curl --request POST \
  --url https://api.0xkey.io/public/v1/submit/create_webhook_endpoint \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-Stamp: <string> (see Authorizations)' \
  --data '{
    "type": "ACTIVITY_TYPE_CREATE_WEBHOOK_ENDPOINT",
    "timestampMs": "1781250000000",
    "organizationId": "<organization-id>",
    "parameters": {
      "url": "https://example.com/webhooks/0xkey",
      "name": "Production activity webhook",
      "subscriptions": [
        {
          "eventType": "ACTIVITY_UPDATES",
          "filtersJson": "",
          "isActive": true
        }
      ]
    }
  }'

{
  "activity": {
    "id": "<activity-id>",
    "status": "ACTIVITY_STATUS_COMPLETED",
    "type": "ACTIVITY_TYPE_CREATE_WEBHOOK_ENDPOINT",
    "organizationId": "<organization-id>",
    "result": {
      "createWebhookEndpointResult": {
        "endpointId": "<endpoint-id>",
        "webhookEndpoint": {
          "endpointId": "<endpoint-id>",
          "organizationId": "<organization-id>",
          "url": "https://example.com/webhooks/0xkey",
          "name": "Production activity webhook",
          "isActive": true,
          "subscriptions": [
            {
              "eventType": "ACTIVITY_UPDATES",
              "filtersJson": "",
              "isActive": true
            }
          ]
        }
      }
    }
  }
}