The FogBugz API can be used alone or in conjunction with FogBugz webhooks and third party services such as Slack, Salesforce, or TestRail (among many others). Not interested in writing code? Check out Zapier’s FogBugz integrations.

If you are interested in building out your own solution, we’re here to help. Below, you’ll find some general rules for API requests as well as links to other resources. Find links to our full documentation in the sidebar to the left.

Looking for our old documentation? Still using FogBugz For Yor Server? Click here.

Prefer to work with JSON? Click here.

General rules for API requests

  1. You can use GET or POST.  If you are submitting files however, you must use a enctype=”multipart/form-data” POST.
  2. All arguments to the API are name/value pairs in the GET or POST request. e.g. a GET request: http://www.example.com/api.asp?token=24dsg34lok43un23&cmd=new&sTitle=New%20Case&sEvent=something
  3. FogBugz is going to be religiously UTF-8.
  4. All dates should be in ISO 8601 UTC format, e.g. 2013-01-21T14:24:06Z
    • To avoid inconsistencies caused by individual user localization, we recommend using ISO for dates in search strings
  5. All API requests will have a cmd argument indicating what you want to do, like cmd=logon in the logon example.
  6. All API requests must have a token argument indicating the logon session except cmd=logon. The token can be used indefinitely, and will only be invalidated by executing a logoff command with that token or by changing the user’s password.
  7. The response is a valid XML file in UTF-8 format containing an outer <response> tag at the root.
  8. If the first child node is <error>, something went wrong.
  9. If the token is not supplied, or if the token does not correspond to a logged-in user, you’ll get error code 3:
    <response><error code="3">Not logged on</error></response>
  10. Since these requests operate against URLs, they should be URL encoded.

Developer Resources

Visit our developer resources site for to find a Quick Start Guide to working with the FogBugz API along with recipes for a few popular API tasks.

Support

Still have questions? Our support team is here to help.