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.

Check our docs to see what endpoints we support for each integration.

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.

If this is a production account, the account token are available in the dashboard and should be stored in your database.

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

Wrong API Key

Update authentication or relink.

For more information on relinking, go to this guide.

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.

Check our docs on how to format our requests to the Merge API.

Check our docs to see what common models our integrations support.

Check for a valid subdomain. If it is accurate, contact support.

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.

Did this answer your question?