Webhooks

Another way to receive data is by setting up Webhooks events in your backend.

Railz uses webhooks to notify your application when an event happens in your account. Webhooks are particularly useful for asynchronous events like when a business's accounting data has been synchronized, a new connection was created, or posting of a transaction was successful.

📘

Setting up Webhooks in your Sandbox

Webhooks are not currently available in the Sandbox environment.

Best Practices

Order of events

Railz does not guarantee the delivery of events in the order in which they are generated. For example, creating a connection might generate the following events:

  • New Connection
  • Authentication Completed
  • Data Synchronized (if connection successful)
  • Connection Disconnected

Your endpoint should not expect delivery of these events in this order and should handle this accordingly.

Security

Your server must accept HTTP POST requests and respond to each event with a 200 response, so we can have a confirmation that the transmission of the event was properly completed.

Your server must have a valid SSL certificate.