Get Webhook by ID

Retrieve details of a specific webhook by its ID.

Endpoint

GET /api/webhooks/:webhookId

Headers

X-API-Key: your-api-key

Parameters

Path:

• webhookId (string, required) - The webhook ID (format: wh_ followed by 32 hex characters)

Response

{
  "status": true,
  "message": "Webhook retrieved successfully",
  "data": {
    "webhookId": "wh_a1b2c3d4e5f6789012345678901234ab",
    "signingKey": "whsk_live_abc123...",
    "url": "https://your-app.com/webhooks",
    "isActive": true,
    "application": {
      "id": "507f1f77bcf86cd799439011",
      "name": "My Application",
      "clientId": "your-client-id"
    },
    "owner": {
      "id": "507f1f77bcf86cd799439012",
      "name": "John Doe",
      "email": "john@example.com"
    },
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z"
  }
}

Response Fields

Field	Type	Description
webhookId	string	Unique webhook identifier
signingKey	string	Webhook signing key
url	string	Webhook URL
isActive	boolean	Whether the webhook is active
application.id	string	Application ID
application.name	string	Application name
application.clientId	string	Application client ID
owner.id	string	Owner user ID
owner.name	string	Owner name
owner.email	string	Owner email
createdAt	string	Webhook creation timestamp
updatedAt	string	Webhook last update timestamp

Errors

Status	Message
400	Validation failed / Invalid webhook ID format
401	Invalid API key
404	Webhook not found

Example

curl -X GET "https://api.reeng.xyz/api/webhooks/wh_a1b2c3d4e5f6789012345678901234ab" \
  -H "X-API-Key: your-api-key"

Notes

• The webhook must belong to the application associated with your API key
• Webhook ID format: wh_ followed by 32 hexadecimal characters