Back to Help Articles
NEXUS API • 1 min read

Register a webhook endpoint

Screenshot

Summary

Register a webhook so NEXUS posts event payloads to your URL when key events occur. Choose which events to subscribe to and monitor recent deliveries.

Before you start

  • Required role: Admin or Developer
  • Have a public HTTPS endpoint ready to receive POSTs

Steps

  1. Go to Integrations ? NEXUS API ? Webhooks (/nexus_webhooks.cfm).
  2. Under New Endpoint, enter a Label and the Endpoint URL. _(Fields: "Label *", "Endpoint URL *")_
  3. Select Events: Order Placed, Order Shipped, Order Updated, Invoice Ready, Invoice Updated, Payment Received. _(Use preview to see each payload shape)_
  4. Click Create Endpoint.
  5. Watch Recent Deliveries to confirm events are arriving.

What success looks like

The endpoint appears under Registered Endpoints, and triggered events show as successful deliveries.

Gotchas / troubleshooting

  • Use preview to see the JSON type and payload before you build your handler.
  • Failing deliveries in Recent Deliveries usually mean your endpoint returned a non-2xx or timed out.

Related

  • Create a NEXUS API credential
  • View API usage

Was this article helpful?

Yes (10) No (9)

Related Articles

Still need help?

Submit a Support Ticket