Push Webhooks

The Push Status event is fired when a push API request has finished processing through Railz and the accounting service provider.

Event Object

The webhook payload is sent in standard JSON format and contains an event object with the following information represented by key-value pairs (KVPs):

Element	Type	Description
`event`	string	Unique event name for the webhook. Set to `push`.
`connectionId`	string	The connection id associated with the webhook. Automatically assigned by Railz. See connections for more details.
`businessName`	string	The business name associated with the webhook. See businesses for more details.
`serviceName`	string	The name of the connected integration. See possible enum values.
`pushCommunicationId`	string	Unique push request ID. Automatically assigned by Railz.
`sourceObjectIds`	array	An array of strings representing the created object ids in the service providers.
`dataType`	string	The data type associated with the webhook. See /data/dataTypes endpoint for all possible enum values.
`requestedOn`	string	The date and time at which the batch push was requested. See date format for more details.
`completedOn`	string	The date and time at which the batch push was completed. See date format for more details.
`status`	string	The status of the batch push request. Possible values: `success`, `failed`.
`responseCode`	integer	Standard HTTP response code from the service provider. In general, 200 HTTP codes correspond to success, 40X codes are for developer- or user-related failures, and 50X codes are for Railz-related issues.
`validation`	object	An object containing an array of `errors`. Returned if a specific batch push object failed.

Each object in the errors array may include the following elements:

Element	Type	Description
`field`	string	The name of the element or property in the original request associated with the validation or error.
`message`	string	A user-friendly validation or error message sent by the service provider.

Example Push Event Objects

{
  "data": {
    "event": "push",
    "connectionId": "CON-0a4e97aa-7a77-bbbb-00aa-b1b1001aa00",
    "businessName": "BIZ-d6b1c7d3-fe41-4447-ae72-3814b78b5142",
    "serviceName": "quickbooks",
    "dataType": "invoice",
    "pushCommunicationId": "60473b57f0cdd1683ca71f60",
    "sourceObjectIds": ["354"],
    "requestedOn": "2021-03-09T19:56:03.952Z",
    "completedOn": "2021-03-09T19:56:03.952Z",
    "status": "success",
    "responseCode": "200"
	},
	"requestId": "a3b4fc83-3e24-41aa-ba99-13cab09b0b7a"
}

{
  "data": {
    "event": "push",
    "connectionId": "CON-0a4e97aa-7a77-bbbb-00aa-b1b1001aa00",
    "businessName": "BIZ-d6b1c7d3-fe41-4447-ae72-3814b78b5142",
    "serviceName": "quickbooks",
    "dataType": "invoice",
    "pushCommunicationId": "60473b57f0cdd1683ca71f60",
    "sourceObjectId": "354",
    "requestedOn": "2021-03-09T19:56:03.952Z",
    "completedOn": "2021-03-09T19:56:03.952Z",
    "status": "failed",
    "responseCode": "400",
    "validation": {
      "errors": [
        {
          "field": "currencyRef",
          "message": "Business Validation Error: Multi Currency should be enabled to perform this operation."
        }
      ]
    }   
	},
	"requestId": "a3b4fc83-3e24-41aa-ba99-13cab09b0b7a"
}