Common error messages for partner integrations
The following table describes the errors you might encounter, and their common fixes:
Error Code | Description | Common fix |
---|---|---|
400 | Incorrect request. The server received a request it couldn’t understand. Often caused by typos, invalid characters, or improper syntax. | Check the request for errors and try again. |
401 | Unauthorized. The request lacked the valid authentication required. Often caused if the wrong authentication type is given with the request. | If you’re trying to call a public API, make sure that you’re providing a valid API Key and BUID. If you’re trying to call a private API, make sure that you have a valid access token that has access to your customer’s BUID. |
403 | Forbidden. Often caused if you or your customer don’t have the required access. This is typically due to admin permissions. | Check if the application is enabled, check that your customer has access to the domain and check that your customer has the correct admin permissions. Display the following message to the end user: “You need a paid Trustpilot plan to use this integration. Contact Trustpilot here to get access.” |
404 | The server couldn’t find what you asked for. Often caused by an incorrect URL (a base URL that isn’t api.trustpilot.com or invitations-api.trustpilot.com) or incorrect PartnerID | Check your URL and PartnerID for errors. |
415 | Unsupported media type. | Make sure that you’ve used the correct Content-Type in your header. |
500 | Server error. | Try again in 5-15 minutes. |
501 | Request not supported. There’s no implementation for your request on the server yet. | If there’s a specific feature that you want to use, ask your Customer Success Manager when implementation on the server is expected. |