Skip to main content

Webhook Receiver Setup

This section describes how to set up your webhook receiver endpoint to receive onboarding requests from B1Link.

Overview​

Your ERP system must expose a webhook receiver endpoint that can accept HTTP POST requests from B1Link. When a supplier completes onboarding, B1Link will POST supplier information to this endpoint.

Endpoint Requirements​

Your webhook receiver endpoint must:

  • Accept HTTP POST requests
  • Be accessible over HTTPS (required for security)
  • Return appropriate HTTP status codes
  • Handle the webhook payload structure (see Webhook Payload Reference)

Configuration Steps​

  1. Create Your Webhook Endpoint - Implement an HTTP POST endpoint in your ERP system
  2. Ensure HTTPS - Your endpoint must use HTTPS (not HTTP)
  3. Configure in B1Link Portal - Provide your webhook receiver URL to your B1Link administrator
  4. Test the Endpoint - Verify it can receive and process webhook payloads

Endpoint Response​

Your webhook receiver should:

  • Return 200 OK when the webhook is successfully received and processed
  • Return appropriate error status codes (4xx, 5xx) if there are issues
  • Process the payload asynchronously if needed (don't block the response)

Security Considerations​

  • Use HTTPS only
  • Consider implementing webhook signature verification (if B1Link provides signatures)
  • Validate the payload structure before processing
  • Log webhook events for auditing

Next Steps​