Merge uses standard HTTP codes to indicate when an API request is successful or errored. The codes listed below are Merge’s Codes, and can be used as guide on how to resolve these errors:
Successful Status Codes: 2xx Codes
2xx Code | Issue | Description |
200 | Success |
|
201 | Successfully created data | This is only for writes |
Merge Returned Error Codes: 4xx Error Codes
Code | Issue | Description | Troubleshooting Tips |
400 | Bad Request | Malformed request- data is not present in the 3rd Party System and/or the 3rd party system does not support the request. | Check if the 3rd party system has the data you want to pull. |
401 | Unauthorized | Unauthorized: authorization is either missing or misconfigured. | If this is a test account, make sure you are using the Account Token stored in the bottom right of their Linked Account page. |
404 | URL Not Found | The resource was not found with the given identifier- the request was entered incorrectly. | Check our docs on how to format our requests to the Merge API. |
404 | URL Not Found | The resource was not found with the given identifier- the data does not exist. | Check if the data is present within the 3rd party system. |
404 | URL Not Found | The resource was not found with the given identifier- the integration does not support that endpoint. | Check our docs to see what common models our integrations support. |
404 | URL Not Found | The resource was not found with the given identifier- the subdomain was entered incorrectly. | Check for a valid subdomain. If it is accurate, contact support. |
429 | Too Many Requests | The Merge Organization has reached a rate limits for the requested linked account, preventing any more requests from going through. | Retry after a few minutes. |
Third Party Returned Error Codes: 4xx Error Codes
Code | Issue | Description | Troubleshooting Tips |
400 | Bad Request | Data is not present in the 3rd party system | Retry and contact support. |
401 | Unauthorized | Authorization is missing | Update authentication or relink. |
403 | Forbidden | Lack of permissions to access this data in 3rd party system. | Check our authentication guides on what permissions you need for each integration. |
404 | URL Not Found | The resource was not found with the given identifier. Either the request was entered incorrectly, the integration does not support that endpoint, or the subdomain was entered incorrectly. |
Server Error Status Codes: 5xx Error Codes
Code | Issue | Description | Troubleshooting Tips |
500 | Internal Server Error | Merge is experiencing a service interruption. | Retry and contact support. |
502/503 | Service Interruption | Check the 3rd party integration status page, they are likely experiencing an outage. |
|