Skip to main content

Organizations API

List and manage organizations.

List organizations​

GET /api/v1/organizations
curl https://app.hooklistener.com/api/v1/organizations \
  -H "Authorization: Bearer hklst_your_api_key"

Response:

{
  "data": [
    {
      "id": "org_abc123",
      "name": "My Organization",
      "slug": "my-org",
      "inserted_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ]
}

Update an organization​

PUT /api/v1/organizations/:id
curl -X PUT https://app.hooklistener.com/api/v1/organizations/org_abc123 \
  -H "Authorization: Bearer hklst_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "organization": {
      "name": "Updated Organization Name"
    }
  }'

Get organization plan​

GET /api/v1/organizations/:id/plan
curl https://app.hooklistener.com/api/v1/organizations/org_abc123/plan \
  -H "Authorization: Bearer hklst_your_api_key"

Response (lists shortened):

{
  "id": "5b2f0c1e-7a4d-4c1b-9e1f-2d3c4b5a6f70",
  "name": "pro_monthly",
  "features": ["webhook_inspector", "api_access", "csv_export", "compare_requests", "static_tunnels"],
  "limits": {
    "incoming_events": 25000,
    "debug_endpoints": 10,
    "debug_requests_retention_days": 14,
    "static_tunnels": 1,
    "forwarding_destinations": 3,
    "debug_request_cases": -1
  },
  "usages": {
    "incoming_events": { "count": 1832, "limit": 25000 },
    "debug_endpoints": { "count": 0, "limit": 10 }
  },
  "is_canceling": false,
  "cancel_effective_date": "2026-10-25T00:00:00Z",
  "next_renovation_date": "2026-10-25"
}

cancel_effective_date is always the end of the current billing period; the plan only ends then if is_canceling is true. limits holds the plan's limits; -1 means unlimited and incoming_events is the monthly request allowance. usages reports the current count for each limit. See Plans & Billing for what each plan includes.

Generate signing secret​

POST /api/v1/organizations/:id/signing_secret
curl -X POST https://app.hooklistener.com/api/v1/organizations/org_abc123/signing_secret \
  -H "Authorization: Bearer hklst_your_api_key"

Roll signing secret​

POST /api/v1/organizations/:id/signing_secret/roll
curl -X POST https://app.hooklistener.com/api/v1/organizations/org_abc123/signing_secret/roll \
  -H "Authorization: Bearer hklst_your_api_key"