Webhooks API

Receive real-time notifications about events in your projects.

Overview

Webhooks allow you to build integrations that subscribe to certain events on Irresistible. When an event occurs, we’ll send an HTTP POST payload to the webhook’s configured URL.

Setting Up Webhooks

POST /api/webhooks

Create a new webhook endpoint.

Request Body:

{
  "url": "https://example.com/webhook",
  "events": ["project.created", "deployment.completed"],
  "secret": "your-webhook-secret"
}

GET /api/webhooks

List all configured webhooks.

PUT /api/webhooks/:id

Update webhook configuration.

DELETE /api/webhooks/:id

Remove a webhook endpoint.

Available Events

Project Events

• project.created - New project created
• project.updated - Project settings updated
• project.deleted - Project deleted
• project.deployed - Project deployed successfully

File Events

• file.created - New file added
• file.updated - File content changed
• file.deleted - File removed

Collaboration Events

• member.added - Team member added
• member.removed - Team member removed
• comment.created - New comment on code

Webhook Payload

{
  "id": "evt_123",
  "type": "project.created",
  "timestamp": "2024-01-01T00:00:00Z",
  "data": {
    "project": {
      "id": "proj_123",
      "name": "New Project"
    }
  }
}

Security

All webhook payloads include a signature header for verification:

X-Irresistible-Signature: sha256=abc123...

Verify webhooks using your webhook secret.