WebHooks | flxbl docs

flxbl docs

slack GitHub

List all webhooks

get

Retrieve a list of all webhook configurations. Requires member role.

Authorizations

Responses

200

List of webhooks.

application/json

401

User is not authorized to list webhooks.

get

GET /sfp/api/webhooks HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Deploy to Production",
    "event": "release.published",
    "provider": "github",
    "config": {
      "url": "text",
      "method": "get",
      "headers": {},
      "filter": {}
    },
    "timeout": 10000,
    "retryCount": 3,
    "retryDelay": 60000,
    "status": "active",
    "lastDeliveryAt": "2025-01-22T07:42:09.000Z",
    "errorCount": 0,
    "createdBy": "john.doe@example.com",
    "createdAt": "2025-01-22T07:42:09.000Z",
    "updatedAt": "2025-01-22T07:42:09.000Z"
  }
]

Delete a webhook

delete

Delete a webhook configuration. Requires member role.

Authorizations

Path parameters

idstringRequired

Webhook ID

Responses

204

The webhook has been successfully deleted.

401

User is not authorized to delete webhooks.

404

Webhook not found.

delete

DELETE /sfp/api/webhooks/{id} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

No content

Get a webhook by ID

get

Retrieve a specific webhook configuration by ID. Requires member role.

Authorizations

Path parameters

idstringRequired

Webhook ID

Responses

200

The webhook configuration.

application/json

401

User is not authorized to view webhooks.

404

Webhook not found.

get

GET /sfp/api/webhooks/{id} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Deploy to Production",
  "event": "release.published",
  "provider": "github",
  "config": {
    "url": "text",
    "method": "get",
    "headers": {},
    "filter": {}
  },
  "timeout": 10000,
  "retryCount": 3,
  "retryDelay": 60000,
  "status": "active",
  "lastDeliveryAt": "2025-01-22T07:42:09.000Z",
  "errorCount": 0,
  "createdBy": "john.doe@example.com",
  "createdAt": "2025-01-22T07:42:09.000Z",
  "updatedAt": "2025-01-22T07:42:09.000Z"
}

Get webhooks for a repository

get

Authorizations

Path parameters

repositoryIdentifierstringRequired

Responses

200

List of webhooks for the repository

application/json

get

GET /sfp/api/repository/webhook/{repositoryIdentifier} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

200

List of webhooks for the repository

[]

Delete a webhook for a repository

delete

Authorizations

Path parameters

repositoryIdentifierstringRequired

Responses

204

The webhook has been successfully deleted

delete

DELETE /sfp/api/repository/webhook/{repositoryIdentifier} HTTP/1.1
Host: 
Authorization: Bearer JWT
Accept: */*

204

The webhook has been successfully deleted

No content

Handle incoming webhook events

post

Header parameters

x-github-eventstringRequired

x-github-deliverystringRequired

x-hub-signature-256stringRequired

Responses

200

The webhook event has been processed successfully

post

POST /sfp/api/repository/webhook HTTP/1.1
Host: 
x-github-event: text
x-github-delivery: text
x-hub-signature-256: text
Accept: */*

200

The webhook event has been processed successfully

No content

Update a webhook

patch

Update a webhook configuration. Requires member role.

Authorizations

Path parameters

idstringRequired

Webhook ID

Body

namestringOptional

A human-readable name for the webhook

Example: Deploy to Production

eventstringOptional

The event that triggers this webhook

Example: release.published

configall ofOptional

Provider-specific configuration

Example: {"repository":"owner/repo","workflow":"deploy.yml","ref":"main"}

timeoutnumberOptional

Timeout in milliseconds

Example: 10000

retryCountnumberOptional

Number of retry attempts

Example: 3

retryDelaynumberOptional

Delay between retries in milliseconds

Example: 60000

statusstring · enumOptional

Current status of the webhook

Example: activePossible values:

Responses

200

The webhook has been successfully updated.

application/json

400

Invalid webhook configuration.

401

User is not authorized to update webhooks.

404

Webhook not found.

patch

PATCH /sfp/api/webhooks/{id} HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 145

{
  "config": {
    "url": "https://new-api.example.com/webhook",
    "method": "post",
    "headers": {
      "Content-Type": "application/json",
      "X-New-Header": "new-value"
    }
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Deploy to Production",
  "event": "release.published",
  "provider": "github",
  "config": {
    "url": "text",
    "method": "get",
    "headers": {},
    "filter": {}
  },
  "timeout": 10000,
  "retryCount": 3,
  "retryDelay": 60000,
  "status": "active",
  "lastDeliveryAt": "2025-01-22T07:42:09.000Z",
  "errorCount": 0,
  "createdBy": "john.doe@example.com",
  "createdAt": "2025-01-22T07:42:09.000Z",
  "updatedAt": "2025-01-22T07:42:09.000Z"
}

Queue webhooks for an event

post

Queue all active webhooks for a specific event. The deliveries will be processed asynchronously.

Authorizations

Body

eventstringRequired

The event that triggers the webhooks

Example: document.created

payloadobjectRequired

The event payload

Example: {"id":"doc123","name":"example.md","type":"markdown","createdBy":"user@example.com"}

Responses

202

Webhook deliveries have been queued

application/json

post

POST /sfp/api/webhooks/trigger HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "event": "user.created",
  "payload": {
    "userId": "123",
    "action": "created",
    "timestamp": "2025-05-20T12:53:52.660Z"
  }
}

202

Webhook deliveries have been queued

[
  {
    "success": true,
    "statusCode": 1,
    "error": "text",
    "duration": 1,
    "message": "text",
    "providerDetails": {
      "method": "get",
      "url": "text",
      "headers": {},
      "filtered": true,
      "queued": true,
      "deliveryId": "text",
      "notFound": true,
      "eventName": "text",
      "webhookId": "text",
      "reason": "text",
      "response": {}
    }
  }
]

Create a new webhook

post

Create a new webhook configuration. Requires member role.

Authorizations

Body

repositoryIdentifierstringRequired

Repository identifier in format owner/repo

Example: octocat/hello-world

webhookUrlstringRequired

URL where GitHub should send webhook events

Example: https://example.com/webhook

Responses

201

The webhook has been successfully created.

application/json

400

Invalid webhook configuration.

401

User is not authorized to create webhooks.

post

POST /sfp/api/webhooks HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 206

{
  "name": "Simple Webhook",
  "event": "user.created",
  "provider": "http",
  "config": {
    "url": "https://api.example.com/webhook",
    "method": "post",
    "headers": {
      "Content-Type": "application/json",
      "X-API-Key": "your-api-key"
    }
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Deploy to Production",
  "event": "release.published",
  "provider": "github",
  "config": {
    "url": "text",
    "method": "get",
    "headers": {},
    "filter": {}
  },
  "timeout": 10000,
  "retryCount": 3,
  "retryDelay": 60000,
  "status": "active",
  "lastDeliveryAt": "2025-01-22T07:42:09.000Z",
  "errorCount": 0,
  "createdBy": "john.doe@example.com",
  "createdAt": "2025-01-22T07:42:09.000Z",
  "updatedAt": "2025-01-22T07:42:09.000Z"
}

Queue a payload for delivery to a webhook

post

Queue a payload for delivery to a specific webhook. The delivery will be processed asynchronously.

Authorizations

Path parameters

idstringRequired

Webhook ID

Body

payloadobjectRequired

The payload to deliver to the webhook endpoint

Example: {"event":"deployment","environment":"production","status":"success"}

Responses

202

Webhook delivery has been queued

application/json

post

POST /sfp/api/webhooks/{id}/deliver HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 104

{
  "payload": {
    "event": "user.notification",
    "message": "Hello World",
    "timestamp": "2025-05-20T12:53:52.660Z"
  }
}

202

Webhook delivery has been queued

{
  "success": true,
  "statusCode": 1,
  "error": "text",
  "duration": 1,
  "message": "text",
  "providerDetails": {
    "method": "get",
    "url": "text",
    "headers": {},
    "filtered": true,
    "queued": true,
    "deliveryId": "text",
    "notFound": true,
    "eventName": "text",
    "webhookId": "text",
    "reason": "text",
    "response": {}
  }
}

Create a webhook for a repository

post

Authorizations

Body

repositoryIdentifierstringRequired

Repository identifier in format owner/repo

Example: octocat/hello-world

webhookUrlstringRequired

URL where GitHub should send webhook events

Example: https://example.com/webhook

Responses

201

The webhook has been successfully created

application/json

post

POST /sfp/api/repository/webhook/create HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "repositoryIdentifier": "octocat/hello-world",
  "webhookUrl": "https://example.com/webhook"
}

201

The webhook has been successfully created

{
  "id": 1,
  "url": "text",
  "events": [
    "text"
  ],
  "active": true,
  "secret": "text"
}

Update a webhook for a repository

post

Authorizations

Body

repositoryIdentifierstringRequired

Repository identifier in format owner/repo

Example: octocat/hello-world

webhookUrlstringRequired

URL where GitHub should send webhook events

Example: https://example.com/webhook

Responses

200

The webhook has been successfully updated

application/json

post

POST /sfp/api/repository/webhook/update HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 89

{
  "repositoryIdentifier": "octocat/hello-world",
  "webhookUrl": "https://example.com/webhook"
}

200

The webhook has been successfully updated

{
  "id": 1,
  "url": "text",
  "events": [
    "text"
  ],
  "active": true
}