×
Freshbooks
Official App
Free – Google Play
Get it
Skip to Main Content
FreshBooks is Loved by American Small Business Owners
FreshBooks is Loved by Canadian Small Business Owners
FreshBooks is Loved by Small Business Owners in the UK

Tasks

Staff have access to the API calls listed below if the Time Tracking tab is enabled for staff. You can enable or disable the Time Tracking tab under Settings->Permissions->Staff Permissions. Please note that the ‘project_id’ filter for task.list would only work for staff if they are assigned to the project.

task.create

Create a new task.

Request

<?xml version="1.0" encoding="utf-8"?>

  
    Yard Work      
    1      
    15.00          
    Grass cutting, hedge trimming, etc.
  

Response

<?xml version="1.0" encoding="utf-8"?>

  211

task.update

Update an existing task.

Request

<?xml version="1.0" encoding="utf-8"?>

  
    211
    
  

Response

<?xml version="1.0" encoding="utf-8"?>

task.get

Retrieve an existing task.

Request

<?xml version="1.0" encoding="utf-8"?>

  211

Response

<?xml version="1.0" encoding="utf-8"?>

  
    211
    Research
    
    1
    180
  

task.delete

Delete an existing task.

Request

<?xml version="1.0" encoding="utf-8"?>

  211

Response

<?xml version="1.0" encoding="utf-8"?>

task.list

Returns a list of tasks in alphabetical order.

Note: This method uses pagination.

Filters
  • project_id – returns only tasks associated with a given project

Request

<?xml version="1.0" encoding="utf-8"?>

  23           
  1                        
  15               

Response

<?xml version="1.0" encoding="utf-8"?>

  
    
      211
      Research
      
      1
      180
    
    
    ...
    
    ...