🔄 Webhooks Overview

Automate workflows and integrate BCE Lambda with your tools by creating and managing webhooks.

Why Use Webhooks?

Real-time event delivery for your functions
Customizable request formats and signatures
Secure with HTTP authentication and tokens

Getting Started

Create a webhook in the BCE Console
Configure delivery settings with your endpoint
Validate and activate your webhook

Creating a Webhook

Webhook Payload Format


{
  "webhook_id": "wh_123456",
  "target_url": "https://api.integration.co/webhook",
  "created_at": "2025-09-28T14:33:22Z",
  "config": {
    "headers": {
      "Authorization": "Bearer token-here",
      "Content-Type": "application/json"
    },
    "payload_template": "{ \"event_type\": \"{{.Type}}\" }"
  },
  "last_event": {
    "delivered": "2025-09-28T14:45:15Z",
    "status": 200
  }
}

Event Types

• Function execution
• Error notifications
• Deployment triggers

Authentication

• HMAC signatures
• API keys
• Bearer tokens

Available Event Types

⚙️

Function Execution Events

Triggered on function execution success or failure

on_start
on_success
on_error
on_timeout

📦

Deployment Events

Notification on deployment state changes

before_deploy
after_deploy
failed_deploy

⚠️

System Events

Serverless infrastructure notifications

resource_created
resource_updated
resource_deleted

🔁

Scheduling Events

Webhooks for cron-based execution

on_cron_start
on_cron_finish

Error Handling & Debugging

Possible Response Statuses

HTTP 200 - Success

HTTP 400 - Malformed Request

HTTP 401 - Unauthorized

HTTP 500 - Internal Error

Testing Your Webhook

curl -X POST https://webhooks.bcelambda.com/test \
     -H "Authorization: Bearer SECRET_TOKEN"

Error: Webhook not found?

Ensure your webhook is in the activated state and URL is correctly configured.