WRMS ProDocs

Integration guides

Patterns for building on WRMS Pro webhooks — a reliable receiver, syncing records to another system, and connecting automation tools.

Audience:Developer

These are patterns that work well with WRMS Pro webhooks. They describe your side of the integration; WRMS Pro's side is the same for all of them.

A reliable receiver

Expose one HTTPS endpoint, for example https://integrations.example.com.au/wrms.
Read the raw body and verify the signature. Reject anything that fails with 401.
If you have already processed this X-WRMS-Delivery ID, respond 200 and stop.
Put the event on a queue (or save it to a table) and respond 200 straight away.
Process the queue separately, with your own retries.

This keeps you well inside the 10-second limit and makes failures in your downstream systems your problem to retry, rather than WRMS Pro's.

Keep a copy of records in step

Webhooks tell you that a record changed and which one (entity, entityId). Because the data object is not yet documented field by field, design your sync so it:

  • keys everything by organizationId + entityId;
  • treats *.delete events as the signal to remove or archive;
  • tolerates missing or extra fields in data.

Notify your team elsewhere

Subscribe a webhook to quote.status and payment.create, and forward a short message to your team chat when a quote is accepted or a payment arrives. Filter on the event name before forwarding.

Automation tools

Tools that can receive a webhook (a "catch hook" or "webhook trigger") can be pointed at WRMS Pro directly. Most cannot verify the signature themselves; if yours cannot, put a small receiver in front of it that verifies and then forwards.

Testing

  • Use Send test to send ping.test at any time.
  • Watch Deliveries in Settings → Webhooks for status codes and responses.
  • Use a separate webhook for your test endpoint, and delete it when you are finished.

Still need help?

Email support@wrmspro.com or use the contact form. Signed-in users can also send a request from Settings → Support.

On this page