The column on the right hand side has a curl call that demonstrates the required Headers and general format of requests to the FreshBooks API.
\nRequests are authenticated using OAuth2 Bearer tokens which you receive in exchange for a code we issue after a logged-in user performs an authorization grant request. You can create an OAuth application and get a client_id and secret at the developer page.
The FreshBooks API is an interface for accessing your FreshBooks data using JSON. The API makes it easy to create web and desktop applications that integrate with your account. Possible uses for it include automatically creating and sending invoices when users sign up on your website, pulling lists of client information, copying data to 3rd party services, and more...
\nCheck out our Scenarios and API Reference sections to see what to expect, and when you're ready, sign up for a FreshBooks account if you don't have one, and proceed to the developer page to create an application and start development.
\nOh, and we're not trying to be secretive about the URL of the developer page, it's: https://www.my.freshbooks.com/#/developer
\nCreate an account by visiting our sign up page. If you already have a FreshBooks account, log in by visiting our log in page. You can reach out to our support team to have your account put on our partner plan.
\nThere are two required headers:
\nContent-Type: application/jsonAuthorization: BearerIf there’s no one around to help, we’ve got your back. Shoot us an email at api@freshbooks.com and tell us what you’re aiming to accomplish, what you’ve done so far, and what went wrong. Maybe we can find the missing piece of the puzzle together.
\nFreshBooks users are uniquely identified by their email across our entire product. One user may act on several Businesses in different ways, so if leafy@example.com is an Administrator of one account and gets added as a Client on another, they will have some access to both. They could then open a second business of their own, or be added as an employee of another person’s business—we live complicated lives! Our Identity model is how we keep track of it.
\nYou can find ids for the Businesses and Accounts a user can interact with by making a call to the Identity Info endpoint (or /me). An example of its response is in the code pane on the right. The key we care about most is business_memberships.
All of the business objects listed in the business_memberships will have an accountId as well as a role on that business (see Roles below). Those business objects also each have an id which is the business_id. Be careful not to mistake the business’s id for the id of the business_membership object itself.
For example, in the Identity Info (/me) response:
\"business_memberships\": [\n{\n \"id\": 111,\n \"role\": \"owner\",\n \"business\": {\n \"id\": 240340,\n \"business_uuid\": \"046cc001-0002-e93e-1db1-1186b2983879\",\n \"name\": \"Awesome Business Inc.\",\n \"account_id\": \"ABC123\",\n \"date_format\": \"dd/mm/yyyy\",\n \"active\": true\n }\n}\n\nYou can see that the user is an owner on this business which has a business_id of 230340 and an account_id of ABC123.
For historical reasons, FreshBooks has shifted from an account concept to a business concept, but many resources still make use of accountIds.
\nCalls to the /accounting endpoints take this form:
/accounting/account/{accountId}/invoices/invoicesCalls to most non-accounting resources, such as the /timetracking/ and /projects/ endpoints usually require a business_id, for example:
/timetracking/business/{business_id}/time_entriesAll FreshBooks users have an Identity and a Business resource and thus a business_id. Most users have accounts, which represent their own FreshBooks account, but not all. For instance, when a Client receives an invoice, views it, and saves it, they will exist as an Identity in our system with a client Role on a Business, but they do not have an Account of their own. If you know your integration will never need to deal with someone who is just a Client and doesn’t have their own Account, you can ignore this. If you aren’t sure of that, you must gracefully handle the case where you cannot find an account for a user.
\nOver time the logical role names that FreshBooks utilizes have diverged slightly from the names they are given in the FreshBooks application. Below are the relationships.
\nIn order for you to add a logo to your FreshBooks invoice, you will need to do it in two steps.
\nUsing the Uploader endpoint, add your .png or .jpg file. Your response will contain a jwt value. Take that value and add it to your GET call for your new invoice.
You can now use the POST Single Invoice (or Update Invoice) endpoint to apply your logo to an invoice. You will need to add your jwt token under presentation at img_src_logo.
Note: The presentation payload also allows you to set colours based on hex code, change the style of your invoice and a few other customizable options.
\nThis process is similar to adding a logo to an invoice. You will first need to upload the expense image via the uploader endpoint (See the Postman call for the Uploader). You will then receive back a response with the jwt key and it's associated value.
You will use then add this value in your POST body to add this newly uploaded receipt to an expense. For an example, check out the Expenses folder below.
\nTo add a payment gateway to your invoice you will first need to make sure that you have gone through the \"Know Your Client\" process in FreshBooks. This will ensure that you comply to the Terms of Service with either/both of our payment processors, Stripe and FreshBooks Payments. This process will require you to sign up for an account, fill in your business and banking details, tell them what type of business you're managing and how often you would like to have funds deposited into your bank account.
\nOnce you have gone through the KYC process, you can then toggle online payments on an invoice by making a POST call to the payment_options endpoint for the gateway of your choice. For an example of this, look under invoices and choose the POST call for \"Enable Payment Options On Invoice\".
\nTo create a shareable link for your invoice, you need to add an share_link?share_method=share_link parameter to the end of your GET call for the invoice you are looking to share. You will need to make sure the invoice has already been marked as sent. If you want to mark an invoice as sent you can simply follow the steps under invoices (Hint: adding \"status\" as 2 to the body of your PUT call should do the trick.)
Our Includes parameters allow for additional payloads to be added to your existing call, but are hidden unless explicitly called for.
\nAll the Includes parameters associated with your calls can be found in one of the LIST examples posted below. For example, if you want to see the associated Includes parameters for an invoice, simply click on the List Invoices. You will see a list of available Includes a description related to each of them.
This is an important endpoint and likely the first authenticated request you'll want to make to the FreshBooks API.
\nSince you will need to tell us which account you're referring to and other identifiers, you can use this /me endpoint to get your accountId, businessId, identityId and a plethora of information about your FreshBooks account(s).
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"list all clients
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"client's outstanding balance
\n","type":"text/plain"},"key":"include[]","value":"outstanding_balance"},{"disabled":true,"description":{"content":"client's current balance of credit
\n","type":"text/plain"},"key":"include[]","value":"credit_balance"},{"disabled":true,"description":{"content":"balance of draft invoices for client
\n","type":"text/plain"},"key":"include[]","value":"draft_balance"},{"disabled":true,"description":{"content":"overdue balance for client
\n","type":"text/plain"},"key":"include[]","value":"overdue_balance"},{"disabled":true,"description":{"content":"grand total for client
\n","type":"text/plain"},"key":"include[]","value":"grand_total_balance"},{"disabled":true,"description":{"content":"information about late fees
\n","type":"text/plain"},"key":"include[]","value":"late_fee"},{"disabled":true,"description":{"content":"information about late reminders
\n","type":"text/plain"},"key":"include[]","value":"late_reminders"},{"disabled":true,"description":{"content":"last activity time
\n","type":"text/plain"},"key":"include[]","value":"last_activity"}],"variable":[]}},"response":[{"id":"fc48f6f4-4c33-4ec9-8759-2378cb589ec6","name":"List Clients","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"https://api.freshbooks.com/accounting/account/{{accountId}}/users/clients","protocol":"https","host":["api","freshbooks","com"],"path":["accounting","account","{{accountId}}","users","clients"],"query":[{"key":"include%5B%5D","value":"outstanding_balance","description":"client's outstanding balance\n","type":"text","disabled":true},{"key":"include%5B%5D","value":"credit_balance","description":"client's current balance of credit","type":"text","disabled":true},{"key":"include%5B%5D","value":"draft_balance","description":"balance of draft invoices for client","type":"text","disabled":true},{"key":"include%5B%5D","value":"overdue_balance","description":"overdue balance for client","type":"text","disabled":true},{"key":"include%5B%5D","value":"grand_total_balance","description":"grand total for client","type":"text","disabled":true},{"key":"include%5B%5D","value":"late_fee","description":"information about late fees","type":"text","disabled":true},{"key":"include%5B%5D","value":"late_reminders","description":"information about late reminders","type":"text","disabled":true},{"key":"include%5B%5D","value":"last_activity","description":"last activity time","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"X-NewRelic-App-Data","value":"PxQBWV5TCBABVlVSAwEOVlcTGhE1AwE2QgNWEVlbQFtcCxYnRA9QFg1ZWU4DFVdfRgFPCkNFR0gRQlNBEVwADlkHVhZLGhgCH1UXUwBYAlFXBwRZUFYOBQFSU04aABtEVVQBAlVWUFBUBwhSClwDAxFJXwBdElY/"},{"key":"X-RateLimit-Limit","value":"20"},{"key":"X-RateLimit-Remaining","value":"0"},{"key":"X-RateLimit-Reset","value":"1557344286"},{"key":"Retry-After","value":"56"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Expires","value":"Tue, 08 May 2018 19:37:09 GMT"},{"key":"Cache-Control","value":"no-cache"},{"key":"Content-Encoding","value":"gzip"},{"key":"Via","value":"1.1 google"},{"key":"Via","value":"1.1 varnish"},{"key":"Accept-Ranges","value":"bytes"},{"key":"Accept-Ranges","value":"bytes"},{"key":"Age","value":"0"},{"key":"Age","value":"0"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 08 May 2019 19:37:09 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"X-Served-By","value":"cache-mdw17330-MDW"},{"key":"X-Cache","value":"MISS"},{"key":"X-Cache-Hits","value":"0"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Country","value":"CA"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains; preload"}],"cookie":[],"responseTime":null,"body":"{\n \"response\": {\n \"result\": {\n \"clients\": [\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"api.freshbooks@gmail.com\",\n \"fax\": \"\",\n \"fname\": \"Nicholas\",\n \"has_retainer\": null,\n \"home_phone\": null,\n \"id\": 92402,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Jaar\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Space Is Only Noise\",\n \"p_city\": \"Toronto\",\n \"p_code\": \"M6P 3T1\",\n \"p_country\": \"\",\n \"p_province\": \"Ontario\",\n \"p_street\": \"1655 Dupont St. W.\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-05-08 19:25:29\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-05-08 15:25:29\",\n \"userid\": 92402,\n \"username\": \"nicholasjaar2\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"api.freshbooks@gmail.com\",\n \"fax\": \"\",\n \"fname\": \"Ryan\",\n \"has_retainer\": null,\n \"home_phone\": null,\n \"id\": 75162,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Marr\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Ryan Marr\",\n \"p_city\": \"\",\n \"p_code\": \"\",\n \"p_country\": \"\",\n \"p_province\": \"\",\n \"p_street\": \"\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-05-02 14:31:30\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-05-02 13:00:27\",\n \"userid\": 75162,\n \"username\": \"ryanmarr\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"api.freshbooks+1@gmail.com\",\n \"fax\": \"\",\n \"fname\": \"Nicholas\",\n \"has_retainer\": null,\n \"home_phone\": null,\n \"id\": 46834,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Jaar\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Space Is Only Noise\",\n \"p_city\": \"Toronto\",\n \"p_code\": \"M6P 3T1\",\n \"p_country\": \"\",\n \"p_province\": \"Ontario\",\n \"p_street\": \"1655 Dupont St. W.\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-24 17:45:17\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-26 13:52:56\",\n \"userid\": 46834,\n \"username\": \"nicholasjaar\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"api.freshbooks@gmail.com\",\n \"fax\": \"\",\n \"fname\": \"Elbert\",\n \"has_retainer\": null,\n \"home_phone\": \"804-177-0551\",\n \"id\": 32082,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Vatcher\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Blick, Dickinson and Morar\",\n \"p_city\": \"Richmond\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Virginia\",\n \"p_street\": \"9 Park Meadow Street\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:32\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-22 10:37:33\",\n \"userid\": 32082,\n \"username\": \"elbertvatcher\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"mwesthofer5i@imdb.com\",\n \"fax\": \"\",\n \"fname\": \"Myrta\",\n \"has_retainer\": null,\n \"home_phone\": \"832-780-4312\",\n \"id\": 32080,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Westhofer\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Prosacco Group\",\n \"p_city\": \"Houston\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Texas\",\n \"p_street\": \"70347 Ramsey Plaza\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:32\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-05-03 03:45:42\",\n \"userid\": 32080,\n \"username\": \"myrtawesthofer\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"bmichelin5h@github.io\",\n \"fax\": \"\",\n \"fname\": \"Beaufort\",\n \"has_retainer\": null,\n \"home_phone\": \"408-201-8841\",\n \"id\": 32078,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Michelin\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Witting, McDermott and Gutmann\",\n \"p_city\": \"San Jose\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"California\",\n \"p_street\": \"5 Kings Pass\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:32\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-22 10:43:38\",\n \"userid\": 32078,\n \"username\": \"beaufortmichelin\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"tarblaster5g@vk.com\",\n \"fax\": \"\",\n \"fname\": \"Tarra\",\n \"has_retainer\": null,\n \"home_phone\": \"254-975-2685\",\n \"id\": 32076,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Arblaster\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Hermann-Jast\",\n \"p_city\": \"Waco\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Texas\",\n \"p_street\": \"05 Haas Trail\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:31\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-22 10:49:56\",\n \"userid\": 32076,\n \"username\": \"tarraarblaster\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"ranfosso5f@toplist.cz\",\n \"fax\": \"\",\n \"fname\": \"Roger\",\n \"has_retainer\": null,\n \"home_phone\": \"713-881-3522\",\n \"id\": 32074,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Anfosso\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Kuhn, Ondricka and Reilly\",\n \"p_city\": \"Houston\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Texas\",\n \"p_street\": \"01496 Novick Court\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:31\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:31\",\n \"userid\": 32074,\n \"username\": \"rogeranfosso\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"agoodlad5e@redcross.org\",\n \"fax\": \"\",\n \"fname\": \"Ariella\",\n \"has_retainer\": null,\n \"home_phone\": \"718-429-4271\",\n \"id\": 32072,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Goodlad\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Schneider-Hoeger\",\n \"p_city\": \"Bronx\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"New York\",\n \"p_street\": \"77 Melody Hill\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:31\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:31\",\n \"userid\": 32072,\n \"username\": \"ariellagoodlad\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"bscardifield5d@yellowbook.com\",\n \"fax\": \"\",\n \"fname\": \"Brooke\",\n \"has_retainer\": null,\n \"home_phone\": \"913-353-2546\",\n \"id\": 32070,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Scardifield\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"McClure-Dibbert\",\n \"p_city\": \"Kansas City\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Kansas\",\n \"p_street\": \"6911 Pankratz Plaza\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:31\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:31\",\n \"userid\": 32070,\n \"username\": \"brookescardifield\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"egelardi5c@bloglovin.com\",\n \"fax\": \"\",\n \"fname\": \"Evangeline\",\n \"has_retainer\": null,\n \"home_phone\": \"213-187-2288\",\n \"id\": 32068,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Gelardi\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Heaney and Sons\",\n \"p_city\": \"Los Angeles\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"California\",\n \"p_street\": \"02 Glendale Lane\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:31\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:31\",\n \"userid\": 32068,\n \"username\": \"evangelinegelardi\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"acraythorne5b@constantcontact.com\",\n \"fax\": \"\",\n \"fname\": \"Audry\",\n \"has_retainer\": null,\n \"home_phone\": \"608-624-6164\",\n \"id\": 32066,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Craythorne\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Kunze-Kunze\",\n \"p_city\": \"Madison\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Wisconsin\",\n \"p_street\": \"8138 Buena Vista Hill\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:31\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:31\",\n \"userid\": 32066,\n \"username\": \"audrycraythorne\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"cdaviot5a@newyorker.com\",\n \"fax\": \"\",\n \"fname\": \"Crissy\",\n \"has_retainer\": null,\n \"home_phone\": \"574-571-1318\",\n \"id\": 32064,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Daviot\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Langosh-Fritsch\",\n \"p_city\": \"South Bend\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Indiana\",\n \"p_street\": \"0550 Loomis Terrace\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:30\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:31\",\n \"userid\": 32064,\n \"username\": \"crissydaviot\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"imuddimer59@instagram.com\",\n \"fax\": \"\",\n \"fname\": \"Iorgo\",\n \"has_retainer\": null,\n \"home_phone\": \"573-831-6641\",\n \"id\": 32062,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Muddimer\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Borer-Welch\",\n \"p_city\": \"Columbia\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"Missouri\",\n \"p_street\": \"10109 Alpine Terrace\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:30\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:30\",\n \"userid\": 32062,\n \"username\": \"iorgomuddimer\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n },\n {\n \"accounting_systemid\": \"wkMd2g\",\n \"allow_late_fees\": true,\n \"allow_late_notifications\": true,\n \"bus_phone\": \"\",\n \"company_industry\": null,\n \"company_size\": null,\n \"currency_code\": \"USD\",\n \"direct_link_token\": null,\n \"email\": \"mjolley58@moonfruit.com\",\n \"fax\": \"\",\n \"fname\": \"Maryanna\",\n \"has_retainer\": null,\n \"home_phone\": \"626-885-3822\",\n \"id\": 32060,\n \"language\": \"en\",\n \"last_activity\": null,\n \"last_login\": null,\n \"level\": 0,\n \"lname\": \"Jolley\",\n \"mob_phone\": \"\",\n \"note\": null,\n \"notified\": false,\n \"num_logins\": 0,\n \"organization\": \"Haley, Renner and Vandervort\",\n \"p_city\": \"Pasadena\",\n \"p_code\": \"\",\n \"p_country\": \"United States\",\n \"p_province\": \"California\",\n \"p_street\": \"7 Bartelt Plaza\",\n \"p_street2\": \"\",\n \"pref_email\": true,\n \"pref_gmail\": false,\n \"retainer_id\": null,\n \"role\": \"client\",\n \"s_city\": \"\",\n \"s_code\": \"\",\n \"s_country\": \"\",\n \"s_province\": \"\",\n \"s_street\": \"\",\n \"s_street2\": \"\",\n \"signup_date\": \"2019-04-18 18:28:30\",\n \"statement_token\": null,\n \"subdomain\": null,\n \"updated\": \"2019-04-18 14:28:30\",\n \"userid\": 32060,\n \"username\": \"maryannajolley\",\n \"vat_name\": null,\n \"vat_number\": null,\n \"vis_state\": 0\n }\n ],\n \"page\": 1,\n \"pages\": 14,\n \"per_page\": 15,\n \"total\": 205\n }\n }\n}"}],"_postman_id":"febf4dc8-2621-4deb-ae17-35ed05299085"},{"name":"Single Client","id":"476dc7e7-b5d1-424f-900c-fa3efd01778b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"url":"https://api.freshbooks.com/accounting/account/{{accountId}}/users/clients/{{customerId}}","description":"Get a single client with the parameter associated with clientId
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Note: If you do not add an organization to your Client object, organization will automatically be added as the client's first and last name.
Deletes the specified secondary contactid
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Allows you to edit a specific secondary contact
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Will remove all secondary contacts for a single Client Profile
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"If you add an inventory to an item, FreshBooks will decrement that inventory value each time you add that item to an invoice and save (or send) it.
However, qty is seen as the amount of items associated with that sale. Therefore, it will remain unchanged with anytime it is added to an invoice.
For example: You may have 5 boxes of nails. Each box of nails will have 99 nails in it. Therefore, your inventory will equal 5 and your qty will equal 99.
Returns an exact match of the searched SKU
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Changing the name, description and the inventory level of the current item.
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Items are stored from invoice lines to make invoicing easier in the future.
\n","event":[{"listen":"prerequest","script":{"id":"b011d3ff-8112-4d3f-9099-e002c0642a52","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"ef004160-e7cb-4c28-a86d-9fe8577cdd16","type":"text/javascript","exec":[""]}}],"_postman_id":"126d945a-e293-4bfe-a6c9-4bcc57232c0b","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Creates a monthly recurring invoice that sends 3 invoices in total.
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Update invoice profile to two weeks and increase the number of remaining invoices to 10.
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"This will create an invoice profile that will pull unbilled time entries for your client on to the invoice that is generated
\n","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"Invoice Profiles are used to create recurring invoices. They have the ability to be saved as a draft invoice or be automatically sent out to the client via email.
\n","event":[{"listen":"prerequest","script":{"id":"786a89c8-cb8e-4cf3-9a71-a4e2595c381e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"eedf7df9-6280-4875-a073-06905e5b8340","type":"text/javascript","exec":[""]}}],"_postman_id":"1469dc41-f6bb-4aa0-a443-99b9d32f3f90","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":"