API Error Handling

Upwork API returns standard HTTP error codes and provides additional error information in the response body (when allowed by HTTP specification), and in the special HTTP headers. For details on an error message received, please refer to the Error Handling section of our API public documentation.


Still have questions? Ask our API team

If you need assistance with an error response or an unexpected call return, API usage or any other general guidance, please visit Stack Overflow, where Upwork engineers try to answer common usage issues and questions. Please don’t share your API key/secret or any other sensitive information there. Remember that although Stack Overflow questions are periodically addressed by our API team, it is a public source of information.

If you don’t find a solution there, contact our Customer Support team by clicking here. Please make sure you provide the following information on the call to conduct further research:

  • time of the request (if available)
  • method used (GET/POST/PUT/DELETE. Note that PUT and DELETE are overloaded via POST+http_method=<method>)
  • URL of the API resource used. Include all the available details such as keys, signature, token and parameters
  • headers sent on the request
  • username used for authorization
  • environment used to send the request (OS, library, programming language)
  • platform used to send the request (mobile, desktop, command line, web -browser-, etc.)
  • response headers and HTTP status received
  • response body received


Report a bug

If you uncover a bug or have an improvement suggestion, please contact our Customer Support team by clicking here to report it. Make us better, to serve you better.

Have more questions? Submit a request


Incident Status

Select your issue category and subcategory
Please share as much information as you can, including things like:
Attachment (for example, screenshots):
Add Files
    Popular Topics
    Provide more details:
    Attachment (for example, screenshots):
    Add Files
      • Discuss with Upwork Community

      Your request has been submitted

      Your ticket number is XXXXXXXXX
      We will email you as soon as we can.

      Our records show your Upwork account is not active.

      This might be due to no account activity (earnings, payments, contracts, etc.) or because we had to suspend it. When we suspend an account we send an email explaining the reason and whether or not you can take steps to reverse the suspension. Please review that email for more details.

      For general questions, you can visit our Community or review our Terms of Service.

      We’ll start a video chat with you. Please make sure you use a desktop device with a camera to continue the process. Also, allow Upwork temporary use of your camera and microphone. You may disable this access after the chat session.

      If all of our agents are busy when you attempt to chat, please hold, and one of our agents will be with you shortly.

      We noticed that you're currently using a browser that is not supported by our video verify process.

      We recommend that you switch to Google Chrome or Firefox in order to successfully complete verification. Thank you

      Upwork’s Category Specialists are standing by to help you discover and plan new projects.

      Ask them about roles or projects that you want to learn more about. They can also draft job posts for you.

      Your chat will begin in the bottom right corner of this page.

      Upwork’s Category Specialists are currently offline.

      Send us a message below and we’ll respond via email as soon as we can. You can also come back here during business hours (Mon-Fri, 6am-5pm PT) to chat with us.

      How can we help?
      Thanks for your message! A Category Specialist will respond to your message via email as soon as they can.