If the Sinch Fax API refuses a request, it returns an HTTP error and does not create a fax. Here is what the most common errors mean and how to fix them.
401 Unauthorized
The response has an empty body, or your API key, secret or project is wrong. Check that:
- The Project ID in the URL is the project the key belongs to.
- You are using the Key ID as the username and the Key Secret as the password for Basic authentication.
The Key Secret is shown only when the key is created. If you no longer have it, create a new key. See Sinch Access Keys.
403 Project is disabled
Your account has run out of available credit. See Why is my Sinch Fax API project disabled, and how do I re-enable it?
400 and 422 errors
The response includes a message that describes what to fix.
| Message | Possible suggestions |
|---|---|
| No From number was specified or available on the project for use. | Send a from number, or set a default From number on your fax service. See Which phone number do I need to send or receive faxes with the Sinch Fax API? |
| The number you set as from does not belong to you | Use a number that is in this project. |
| The from number is suspended | Contact Sinch Support. |
| The destination country or number type is not permitted | See Which countries can I send faxes to with the Sinch Fax API? |
| The number you set as to is blocked | Check Fax > Number blocking. If there is no rule for the number on that page, contact Sinch Support. |
| The contenturl you provided is invalid | Check the URL and send it again. |
| You must submit at least one file or content URL. | Add a file or a contentUrl. |
| You cannot submit more than 10 total files and content URLs per fax. | Combine your documents, or send more than one fax. |
Phone numbers must be in E.164 format with a leading plus sign, for example +12025550134.
429 Rate limit exceeded
Back off and try again later. If you need a higher rate, contact Sinch Support.
500 and 503 errors, and timeouts
Check the Sinch Status page, then try again after a short wait. Before you resend, check Fax > Faxes to make sure the first request did not create a fax. If the errors continue and no incident is listed, contact Sinch Support with your Project ID and the times of the requests.
Comments
0 comments
Please sign in to leave a comment.