Gilito AIDocs

Webhooks

Configure webhook endpoints to receive real-time notifications when events occur. Supported events: signal.changed, agent.triggered, portfolio.updated, alert.fired.

GET/api/v1/integrations/webhooks

Returns all configured webhook endpoints for the authenticated user.

Response

200 OK
GET/api/v1/integrations/webhooks
curl -X GET "https://api.gilito.ai/api/v1/integrations/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": [
    {
      "id": "wh-abc123...",
      "name": "Trading Signals",
      "url": "https://example.com/webhooks/gilito",
      "events": ["signal.changed", "alert.fired"],
      "active": true,
      "createdAt": "2026-03-01T10:00:00.000Z",
      "lastDeliveryAt": "2026-04-03T14:30:00.000Z",
      "lastDeliveryStatus": 200
    }
  ]
}
POST/api/v1/integrations/webhooks

Create a new webhook endpoint. The secret is used to sign payloads for verification.

Query Parameters

namestringrequired

Friendly name for the webhook.

urlstringrequired

The HTTPS URL to deliver events to.

secretstringrequired

Secret key for HMAC-SHA256 payload signing.

eventsstring[]required

Events to subscribe to: signal.changed, agent.triggered, portfolio.updated, alert.fired.

Response

200 OK
POST/api/v1/integrations/webhooks
curl -X POST "https://api.gilito.ai/api/v1/integrations/webhooks?name={name}&url={url}&secret={secret}&events={events}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "wh-abc123...",
    "name": "Trading Signals",
    "url": "https://example.com/webhooks/gilito",
    "events": ["signal.changed", "alert.fired"],
    "active": true,
    "createdAt": "2026-04-04T09:00:00.000Z"
  }
}
PATCH/api/v1/integrations/webhooks/:id

Update a webhook endpoint. Only provided fields are updated.

Path Parameters

idstringrequired

The webhook ID.

Query Parameters

namestringoptional

Updated name.

urlstringoptional

Updated URL.

secretstringoptional

Updated secret key.

eventsstring[]optional

Updated event subscriptions.

activebooleanoptional

Enable or disable the webhook.

Response

200 OK
PATCH/api/v1/integrations/webhooks/:id
curl -X PATCH "https://api.gilito.ai/api/v1/integrations/webhooks/{id}?name={name}&url={url}&secret={secret}&events={events}&active={active}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "wh-abc123...",
    "name": "Updated Webhook",
    "url": "https://example.com/webhooks/gilito",
    "events": ["signal.changed", "agent.triggered"],
    "active": true,
    "updatedAt": "2026-04-04T09:00:00.000Z"
  }
}
DELETE/api/v1/integrations/webhooks/:id

Delete a webhook endpoint. No further events will be delivered.

Path Parameters

idstringrequired

The webhook ID.

Response

200 OK
DELETE/api/v1/integrations/webhooks/:id
curl -X DELETE "https://api.gilito.ai/api/v1/integrations/webhooks/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "id": "wh-abc123...",
    "status": "deleted"
  }
}
POST/api/v1/integrations/webhooks/:id/test

Send a test event to the webhook endpoint to verify connectivity and signature validation.

Path Parameters

idstringrequired

The webhook ID.

Response

200 OK
POST/api/v1/integrations/webhooks/:id/test
curl -X POST "https://api.gilito.ai/api/v1/integrations/webhooks/{id}/test" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try It
Example Response
{
  "data": {
    "webhookId": "wh-abc123...",
    "testEvent": "signal.changed",
    "deliveryStatus": 200,
    "responseTimeMs": 145,
    "deliveredAt": "2026-04-04T09:00:00.000Z"
  }
}