Writes Warnings and Errors Reference

Warning and Error Codes

This is a reference list of all possible errors and warnings returned by Merge’s API’s POST endpoints.

Issue	Type
Corrupted File CORRUPTED_FILE	Error	Description The file was corrupted, thus Merge was unable to get the contents. Troubleshooting Tips Check that the file passed in the request is readable.
Credential Refresh Failed CREDENTIAL_REFRESH_FAILED	Error	Description Credential refresh for linked account failed when attempting to make an API request. Troubleshooting Tips Navigate to https://app.merge.dev/logs to view the logs for the linked account to get more information.
Writing to Disabled Model DISABLED_MODEL_WRITE	Error	Description A write request to a disabled model was attempted. Troubleshooting Tips Navigate to https://app.merge.dev/configuration/common-models to re-enable the model.
Duplicate Model Exists DUPLICATE_MODEL_EXISTS	Error	Description A model with duplicate unique identifiers already exists. Troubleshooting Tips If testing, ensure that new test data is used in subsequent requests.
Error ERROR	Error	Description A generic error type used for errors not enumerated otherwise in this list. Troubleshooting Tips Use Debug Mode to get the relevant logs for troubleshooting.
Incorrect Field Type INCORRECT_FIELD_TYPE	Error	Description The field’s value was in the incorrect format and Merge was unable to correct it, resulting in the Common Model not being created. Troubleshooting Tips Ensure that the value being passed into the specified source field is the correct data type.
Incorrect Field Type INCORRECT_FIELD_TYPE	Warning	Description The field’s value was in the incorrect format, but Merge was able to infer it and create the Common Model instance. Troubleshooting Tips Ensure that the value being passed into the specified source field is the correct data type and no data is being incorrectly altered when Merge infers the value.
Invalid Field Choice INVALID_FIELD_CHOICE	Error	Description The field value does match an available enum choice for the field. Troubleshooting Tips Consult the available field value choices for the relevant field in the API documentation.
Invalid File URL INVALID_FILE_URL	Error	Description The file associated with the URL passed in failed to download. Troubleshooting Tips Make sure that the file url passed in is accurate.
Invalid Request Content Type INVALID_REQUEST_CONTENT_TYPE	Error	Description The content type for the body of the request was not correct. Troubleshooting Tips Ensure that the value for content_type in your request headers is application/json.
Invalid Request Shape INVALID_REQUEST_DATA_SHAPE	Error	Description The request body does not match the expected request shape for the endpoint. Troubleshooting Tips Ensure that the request body is in the correct format.
Missing Permission MISSING_PERMISSION	Error	Description The linked account token passed into the request does not have permission to perform this operation. Troubleshooting Tips Ensure the account token is being passed into the request. Check https://app.merge.dev/issues for more information.
Missing Required Fields MISSING_REQUIRED_FIELD	Error	Description This request is missing fields required to add / update the Common Model in the given third-party platform. Troubleshooting Tips Ensure the request body includes all required fields for creating the Common Model instance.
Model Not Found MODEL_NOT_FOUND	Error	Description The ID of the field does not refer to an existing model. Troubleshooting Tips Ensure that the UUID of the error source matches a Merge common model ID.
Model With Duplicate Unique Field Exists MODEL_WITH_DUPLICATE_UNIQUE_FIELD_EXISTS	Error	Description A model with a field which must be unique already exists. Troubleshooting Tips If testing, ensure that new test data is used in subsequent requests.
Provider Error PROVIDER_ERROR	Error	Description An error from the third-party platform’s API prevented the request. Troubleshooting Tips Use Debug Mode to get the relevant logs for troubleshooting.
Too Many Requests RATE_LIMITED	Error	Description The third-party platform ran into rate limiting issues. Troubleshooting Tips Reach out to Merge for support at [email protected].
Unsupported Operation UNSUPPORTED_OPERATION	Error	Description Merge does not yet support this operation for the provided integration. Troubleshooting Tips Ensure the request method is correct, and that you are making requests to the correct endpoint.
Unsupported Test Request UNSUPPORTED_TEST_REQUEST	Error	Description The request you are making is only compatible with production linked accounts. Troubleshooting Tips Test account tokens may only be used to retrieve from list endpoints. If you need assistance with your setup, please reach out to [email protected]!