API Reference
Base URL: https://api.skooh.io
Authentication
All API requests require authentication using a Bearer token. Create an API key in Settings → API Keys.
curl -X GET 'https://api.skooh.io/hook_admin/hooks' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json'
Webhook Management
GET
/hook_admin/hooks
List all webhook endpoints for a user.
# Query Parameters
user_id: string (required) - Your user ID
# Response
{
"hooks": [
{
"token": "abc123",
"name": "GitHub Webhook",
"created_at": "2024-01-01T00:00:00Z",
"payload_count": 42
}
]
}POST
/hook_admin/hooks
Create a new webhook endpoint.
# Query Parameters
user_id: string (required)
# Request Body
{
"name": "My Webhook"
}
# Response
{
"token": "generated_token",
"name": "My Webhook",
"created_at": "2024-01-01T00:00:00Z"
}DELETE
/hook_admin/hooks/:token
Delete a webhook endpoint.
# Path Parameters token: string (required) - The webhook token # Query Parameters user_id: string (required)
Sending Webhooks
Send webhooks to your Skooh endpoint. The webhook will be queued and forwarded to any connected proxies/desktop apps.
ANY
/hook/:token
Supports all HTTP methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
curl -X POST 'https://api.skooh.io/hook/YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"event": "order.created",
"data": {
"order_id": "12345",
"amount": 99.99
}
}'API Key Management
GET
/hook_admin/api_keys
List all API keys for a user.
POST
/hook_admin/api_keys
Create a new API key. The key value is only returned once.
# Request Body
{
"name": "Production API Key",
"expires_in_days": 365 // optional
}
# Response
{
"api_key": "sk_live_...", // Only shown once!
"id": 1,
"name": "Production API Key"
}DELETE
/hook_admin/api_keys/:id
Delete an API key. This action cannot be undone.
Response Codes
200Success
201Created
400Bad Request - Invalid input
401Unauthorized - Invalid or missing API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limit exceeded