Integration Labs uses a combination of error handling strategies to ensure that data is synced correctly and that the user is notified of any errors that occur.

Reading Data

When reading data from an integration, Integration Labs will attempt to read all data from the platform. If an unexpected error occurs, Integration Labs will mark that datamodel as FAILED. You can use the Sync Completed Webhook to be notified when a sync has completed and check the status of the datamodels.

Writing Data

When writing data to an integration, Integration Labs will attempt to write all data to the platform. If an unexpected error occurs, Integration Labs will return an error response with the following format:

{
  "error": {
    "code": "An Integration Labs Error Code (see error codes below)",
    "message": "A helpful message from Integration Labs describing the error after trying to parse the platform_error",
    "platform_error": "The full error message returned by the integration platform"
  }
}

Accuracy of Error Codes

Integration Labs uses an LLM to attempt to map the error returned by the integration platform to a Integration Labs error code and a helpful error message. Error codes returned by Integration Labs may not be accurate.

We are continuously improving our LLM to ensure that the error codes returned by Integration Labs are accurate.

Error Codes

All Integration Labs Write APIs will return a 400 status code with one of the following error codes when an error occurs.

Error CodeError Message FormatDescription
missing-paramsMissing required field: {field_name}. A helpful error messageThrown when a required field is missing by the integration platform
invalid-paramsInvalid field: {field_name}. A helpful error messageThrown when a field is invalid by the integration platform
record-already-existsRecord already exists with given: {field_name}. A helpful error messageThrown when a record already exists with the given field by the integration platform
operation-deniedOperation Denied: A helpful error messageThrown when the integration platform denies the operation
unknown-errorUnknown error: : A helpful error messageThrown when RootFi cannot map the error to a known error code
platform-deniedThe underlying platform denied the requestThrown when the underlying platform denies a request

Internal errors

If an internal error occurs, Integration Labs will return a 500 status code with the an internal-error error code. If you receive this error code, please contact us at. We are monitoring our internal errors and will fix them as soon as possible.