Send Outbound Webhooks

Why You Would Use This

This is the core outbound operation: enqueue event payloads and let HookBridge handle delivery, retries, and observability.

Console Workflow

1. Open Endpoints and create/select your outbound endpoint.
2. Copy the endpoint ID (ep_...) from the endpoint workflow.
3. Use that endpoint_id in your API or SDK send request.
4. Open Messages to validate delivery status and inspect attempts.

The console currently helps you manage endpoints and monitor messages; actual outbound send requests are API/SDK-driven.

API Workflow

API reference: Send webhook

curl

curl -X POST https://send.hookbridge.io/v1/webhooks/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_id": "YOUR_ENDPOINT_ID",
    "payload": {
      "event": "order.created",
      "order_id": "ord_123"
    },
    "headers": {
      "X-Source": "billing-service"
    },
    "idempotency_key": "order-123-created-v1"
  }'

Node.js

import { HookBridge } from '@hookbridge/sdk';

const client = new HookBridge({ apiKey: 'YOUR_API_KEY' });

const result = await client.send({
  endpointId: 'YOUR_ENDPOINT_ID',
  payload: {
    event: 'order.created',
    order_id: 'ord_123'
  },
  headers: { 'X-Source': 'billing-service' },
  idempotencyKey: 'order-123-created-v1'
});

console.log(result.messageId);

Python

from hookbridge import HookBridge

client = HookBridge(api_key="YOUR_API_KEY")

result = client.send(
    endpoint_id="YOUR_ENDPOINT_ID",
    payload={
        "event": "order.created",
        "order_id": "ord_123",
    },
    headers={"X-Source": "billing-service"},
    idempotency_key="order-123-created-v1",
)

print(result.message_id)

Go

client, _ := hookbridge.NewClient("YOUR_API_KEY")

result, _ := client.Send(ctx, hookbridge.SendRequest{
    EndpointID: "YOUR_ENDPOINT_ID",
    Payload: map[string]any{
        "event":    "order.created",
        "order_id": "ord_123",
    },
    Headers:        map[string]string{"X-Source": "billing-service"},
    IdempotencyKey: "order-123-created-v1",
})

fmt.Println(result.MessageID)

Ruby

require "hookbridge"

client = HookBridge.new(api_key: "YOUR_API_KEY")

result = client.send(
  endpoint_id: "YOUR_ENDPOINT_ID",
  payload: {
    event: "order.created",
    order_id: "ord_123",
  },
  headers: { "X-Source" => "billing-service" },
  idempotency_key: "order-123-created-v1"
)

puts result.message_id

PHP

<?php

use HookBridge\HookBridge;

$client = new HookBridge('YOUR_API_KEY');

$result = $client->send(
    endpointId: 'YOUR_ENDPOINT_ID',
    payload: [
        'event' => 'order.created',
        'order_id' => 'ord_123',
    ],
    headers: ['X-Source' => 'billing-service'],
    idempotencyKey: 'order-123-created-v1',
);

echo $result->messageId . PHP_EOL;

Tips

• Use a consistent JSON shape for each event type so failures and replays are easier to compare.
• Use idempotency_key for producer retries.
• Use custom headers sparingly and avoid sensitive values.
• Track and persist message_id for downstream operations.