Inbound Endpoint Lifecycle

Why You Would Use This

Inbound endpoint lifecycle is how you control who can send traffic to HookBridge, where accepted traffic is forwarded, and when an endpoint should stop accepting requests.

When you create an inbound endpoint, HookBridge returns an ingest_url and secret_token once. Store both securely because external providers use that ingest URL to send events into your pipeline.

Console Workflow

1. Open Endpoints and switch to Inbound.
2. Create an inbound endpoint with your forwarding URL.
3. Configure verification settings and idempotency headers.
4. Pause the endpoint when you need to temporarily reject new inbound traffic.
5. Resume the endpoint when you are ready to accept traffic again.
6. Delete the endpoint when permanently retired.

Behavior Notes

• pause causes new incoming webhooks for that endpoint to be rejected.
• resume starts accepting incoming webhooks again.
• delete removes the endpoint from active use. It no longer accepts new inbound webhooks, but already-created messages can still continue delivery.

API Workflow

API reference:

• Create inbound endpoint
• List inbound endpoints
• Get inbound endpoint
• Update inbound endpoint
• Pause inbound endpoint
• Resume inbound endpoint
• Delete inbound endpoint

# Create inbound endpoint
curl -X POST https://api.hookbridge.io/v1/inbound-endpoints \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Stripe","url":"https://your-app.example/inbound/stripe"}'

# List inbound endpoints
curl https://api.hookbridge.io/v1/inbound-endpoints \
  -H "Authorization: Bearer YOUR_API_KEY"

# Update inbound endpoint
curl -X PATCH https://api.hookbridge.io/v1/inbound-endpoints/YOUR_INBOUND_ENDPOINT_ID \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"Updated inbound description"}'

# Pause inbound endpoint
curl -X POST https://api.hookbridge.io/v1/inbound-endpoints/YOUR_INBOUND_ENDPOINT_ID/pause \
  -H "Authorization: Bearer YOUR_API_KEY"

# Resume inbound endpoint
curl -X POST https://api.hookbridge.io/v1/inbound-endpoints/YOUR_INBOUND_ENDPOINT_ID/resume \
  -H "Authorization: Bearer YOUR_API_KEY"

# Delete inbound endpoint
curl -X DELETE https://api.hookbridge.io/v1/inbound-endpoints/YOUR_INBOUND_ENDPOINT_ID \
  -H "Authorization: Bearer YOUR_API_KEY"