Skip to main content

Integrate in 5 Minutes

Quick Integration Path

This is the fastest way to validate your ERP connection. Follow the three steps below to receive your first event and send a vendor number back to B1Link.

Step 1 — Generate API Key​

  1. Log in to the B1Link portal.
  2. Go to Corporate Onboarding Configuration → ERP Configuration.
  3. Create an API key and copy it immediately (it is shown only once).
  4. Store it securely (e.g. environment variable or secrets vault).

Details: API Keys

Step 2 — Configure Webhook​

  1. Expose an HTTPS POST endpoint that can receive JSON from B1Link.
  2. In the B1Link portal, set your Webhook receiver URL to this endpoint.
  3. Ensure the endpoint returns 200 OK when the webhook is accepted.

Details: Webhook receiver setup · Payload reference

Step 3 — Receive First Event​

  1. Trigger a test onboarding (or use a test supplier) so B1Link sends a webhook to your URL.

  2. From the webhook body, read onboardingRequestErpEventId and the supplier data.

  3. Assign a vendor number in your system.

  4. Send it back with a signed PUT request:

    • URL: {baseUrl}/api/onboarding-request-erp-events/assign-erp-vendor-number-event
    • Body: {"Id": "<onboardingRequestErpEventId>", "ErpVendorNumber": "<your-vendor-number>"}
    • Header: X-B1LINK-Signature = Base64(HMAC-SHA256(request body, API key))

  5. A 204 No Content response means the integration worked.

Details: API endpoint · Signature generation · Code examples

Success Checklist​

  • API key generated and stored securely
  • Webhook URL configured in B1Link and reachable over HTTPS
  • First webhook received and parsed
  • Vendor number sent back with valid signature and 204 response

For testing without signature verification, use the test endpoint.