Dead Letter Queue

The List Hooks endpoint can function as a Dead Letter Queue (DLQ). You can fetch all failed hooks within a specific time range, process them, and then delete them.

Workflow

List Failed Hooks: Use status=failed and filters like postAtAfter (e.g., “yesterday”).

for await (const hook of posthook.hooks.listAll({
  status: 'failed',
  postAtAfter: '2025-01-01T00:00:00Z'
})) {
  console.log(hook.id, hook.path);
}

for hook in client.hooks.list_all(
    status="failed",
    post_at_after="2025-01-01T00:00:00Z"
):
    print(hook.id, hook.path)

for hook, err := range client.Hooks.ListAll(ctx, &posthook.HookListAllParams{
    Status:      posthook.StatusFailed,
    PostAtAfter: time.Date(2025, 1, 1, 0, 0, 0, 0, time.UTC),
}) {
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(hook.ID, hook.Path)
}

curl "https://api.posthook.io/v1/hooks?status=failed&postAtAfter=2025-01-01T00:00:00Z" \
  -H "X-API-Key: $API_KEY"

Process: Iterate through the list and handle the failures (e.g., log them, alert a team, or manually fix the data).
Delete: Once processed, delete the hook to remove it from the queue.
DELETE /hooks/{id}

Automate this with Sequences: You can set up a recurring Sequence Pattern to trigger your DLQ processing endpoint every day.

Bulk Retry

If you had a temporary outage (e.g., your database was down), you can batch retry failures instead of deleting them.

List Failed Hooks (as above).
Extract IDs: Collect the id from each hook (or use the SDK’s bulk retry directly).

Bulk Retry:

const result = await posthook.hooks.bulk.retry({
  hookIDs: ['e5405623-2c1c-460e-9737-c884f7f59035', 'a1b2c3d4-5678-90ab-cdef-1234567890ab', 'f9e8d7c6-5432-10fe-dcba-0987654321fe']
});
console.log(`Retried ${result.affected} hooks`);

result = client.hooks.bulk.retry(
    hook_ids=["e5405623-2c1c-460e-9737-c884f7f59035", "a1b2c3d4-5678-90ab-cdef-1234567890ab", "f9e8d7c6-5432-10fe-dcba-0987654321fe"]
)
print(f"Retried {result.affected} hooks")

result, _, err := client.Hooks.Bulk().Retry(ctx, &posthook.BulkActionByIDs{
    HookIDs: []string{"e5405623-2c1c-460e-9737-c884f7f59035", "a1b2c3d4-5678-90ab-cdef-1234567890ab", "f9e8d7c6-5432-10fe-dcba-0987654321fe"},
})
fmt.Printf("Retried %d hooks\n", result.Affected)

curl -X POST https://api.posthook.io/v1/hooks/bulk/retry \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hookIDs": ["e5405623-2c1c-460e-9737-c884f7f59035", "a1b2c3d4-5678-90ab-cdef-1234567890ab", "f9e8d7c6-5432-10fe-dcba-0987654321fe"]
  }'

​Workflow

​Bulk Retry

Workflow

Bulk Retry