Integrations

The Chainlink WMS REST API and webhooks

The Chainlink WMS REST API connects your ERP, online store or own system with the warehouse, with OAuth2, in every plan. In Professional and Enterprise, signed webhooks report each event.

Available in
API in every plan · webhooks in Professional and Enterprise
Authentication
OAuth2 with an API client
Webhooks
Signed with HMAC-SHA256
Specification
OpenAPI 3.1

Reviewed October 23, 2026 by the Business in a Wave team

01

API coverage

Your ERP sends purchase orders and sales orders, the warehouse executes them, and your system receives the result by webhook or queries it.

  • Products, warehouses, locations and partners
  • Stock by location, lot and serial number
  • Documents, receipts, pick lists and transfers
  • Bulk import
02

How an integration authenticates

An integration authenticates with an API client created in Settings › Integrations › API clients.

  • The client ID and secret are used to request an OAuth2 token
  • The secret is shown once; revoking the client ends its access
  • Chainlink Wizard, printers and readers use device tokens
03

Retrying a write without duplicate documents

With the Idempotency-Key header, a repeated write returns the document already created instead of creating another.

  • Documents accept your system’s document number as an external reference
04

Keeping an ERP synchronized

List endpoints accept updated_since, so your ERP queries only what changed since its last cycle.

  • With webhooks, the notification is sent as soon as the event occurs
05

Limits by plan

When the per-minute limit is exceeded, the API responds with 429 and Retry-After.

FeatureEssentialsProfessionalEnterprise
REST API Yes Yes Yes
Requests per minute 60 300 By contract
API clients 1 5 By contract
Rows per bulk import file 2,000 10,000 By contract
Webhooks No Yes Yes
06

Webhook events

Each subscription selects its events: receipts, pick lists, transfers, shipments, returns, counts, products and stock.

  • HMAC-SHA256 signature with the subscription secret
  • Your system responds with 2xx in less than 15 seconds
  • Up to 5 retries, from 10 seconds to 10 minutes, then hourly requeue for 24 hours
  • The same delivery ID on every retry
07

Technical documentation

The developer portal publishes the OpenAPI specification in JSON and YAML and a Postman collection. The portal is in Spanish; the specification uses English field names.

Frequently asked questions

For any other question, contact sales.

Is the API charged separately? +

No. The API is included in every plan; the plan sets how many requests per minute and how many API clients your company can have. Webhooks are available in Professional and Enterprise.

Can counts be created through the API? +

No. The public API does not include counts; the result of a count reaches your system by webhook when the count is finalized.

How does the API respond when the plan does not include a feature? +

It responds with 402. When the per-minute limit is exceeded, it responds with 429 and the Retry-After header, and a request with invalid data receives 422 with the field to correct.

Subscribe to Chainlink online

Your instance is created when sign-up is complete, ready to set up your warehouse.

Essentials and Professional are purchased online by card: the first month and the implementation are charged at subscription. 30-day trial by invitation: request it from sales.