Skip to Main Content
×
Freshbooks
Official App
Free – Google Play
Get it
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

Contractors

Contractor API calls are only available to an account’s administrator, not to staff members.

contractor.create

Send an email inviting the recipient to collaborate on your projects as a contractor.

Request

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

     
        Name
        email@freshbooks.com 
        25.50 
        1 
        
         
            
                1
            
            
                2
            
        
    

Response

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

    36

contractor.update

Updates information for an existing contractor, including their hourly rate and assigned projects.

Request

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

    
        36 
        Name
        email@freshbooks.com
        25.50 
        1
        
        
            
                1
            
            
                2
            
        
    

Response

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

    36

contractor.get

Returns details for the specified contractor.

Request

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

     36 

Response

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

    
        36
        Test
        test@testing.com
        invited 
        100
        1
        
    

contractor.delete

Delete the contractor with the given contractor_id.

Request

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

     36 

Response

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


contractor.list

Returns a list of contractor summaries in order of descending contractor_id. NOTE: This method uses pagination

Request

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

    1
    1

Response

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

    
        
            22
            Test Contractor
            test@freshbooks.com
            accepted
            10
            6
            
                
                    1
                
                
                    2
                
                
                    3
                
            
        
        
            5
            Test Contractor 2
            test2@freshbooks.com
            accepted
            150
            2
            
                
                    4
                
                
                    7