Staff
Client
Contractor
View Companies

This call returns a list of Companies based on the filters specified. The fields parameter allows you to choose which data fields to return for each Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: code,name,type
Fields to return.
  • Comma separated list of any of the following:
    • address
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • code
    • contacts
    • email
    • fax
    • image
    • lastmodified
    • name
    • phone
    • tags
    • type
    • website
    Example: code,name,phone

OPTIONAL PARAMETERS:

contactdetails
default: false
Contact Details.
  • true - Return email, image, phone for contacts
  • false - Do not return email, image, phone for contacts

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Companies where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Companies where ANY of the specified apifields match
  • all - Companies where ALL of the specified apifields match
divisionid
Division ID (Advanced plan only).
  • divisionid - Companies in specified Division
    Example: 1
id
List of Company IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Companies with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Companies with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Companies added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Companies added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Companies added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Companies added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Companies
  • false - Active Companies
search
Search string.
  • string - Companies where Name or Code contains string
    Example: website
  • !string - Companies where Name and Code do not contain string
    Example: !layout
searchcode
Search string.
  • string - Companies where Code contains string
    Example: website
  • !string - Companies where Code does not contain string
    Example: !layout
searchemail
Search string.
  • string - Companies where Email contains string
    Example: website
  • !string - Companies where Email does not contain string
    Example: !layout
searchname
Search string.
  • string - Companies where Name contains string
    Example: website
  • !string - Companies where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Companies with at least one of the specified Tag ID/s
    Example: 1,2,3
type
Company Type.
  • client - Client Companies
  • contractor - Contractor Companies
  • other - Other Companies
  • staff - Staff Companies

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Companies.
Example: pagenumber=2&pagesize=10 (return Companies 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - Company ID
  • name - Company Name
  • code - Company Code
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Company/Companies

This call adds one or more Companies.
Show Sample POST data

Single Company:
{
   "name":"ABC Ltd",
   "type":"client"
}

Multiple Companies:
[
   {
      "name":"ABC Ltd",
      "type":"client"
   },
   {
      "name":"DEF Co",
      "type":"client"
   },
   {
      "name":"GHI Inc",
      "type":"contractor"
   }
]

REQUIRED PARAMETERS:

name
Company Name.
  • name - Name
    Example: Sample Name
type
Company Type.
  • client - Client Company
  • contractor - Contractor Company
  • other - Other Company

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
code
Company Code.
  • code - Code (abbreviation of Company Name)
    Example: ABC
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
facebook
Facebook URL.
  • facebook - Facebook URL
    Example: http://www.facebook.com/proworkflow
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
imagecontent
Image.
  • imagecontent - Image Data (Base64 encoded 80x80px png image)
    IMPORTANT: Not available when adding multiple companies, an image larger than 100KB will not be added
linkedin
LinkedIn URL.
  • linkedin - LinkedIn URL
    Example: http://www.linkedin.com/proworkflow
phone
Phone number.
  • phone - Phone number
    Example: 0123 456 7890
state
State.
  • state - State
    Example: Somewhere
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
twitter
Twitter URL.
  • twitter - Twitter URL
    Example: http://twitter.com/proworkflow
website
Website.
  • website - Website
    Example: www.proworkflow.com
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Company

This call deletes a Company and optionally the associated Contacts, if you do not delete the Contacts then you must assign them to a new Company afterwards or they will not be usable in the main application.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

deletecontacts
default: true
Delete Company Contacts.
  • true - Delete Company Contacts
  • false - Keep Company Contacts

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Company

This call returns details of a single Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Company

This call updates a single Company.
IMPORTANT: If the Company Type is changed then all Contacts belonging to the Company will be changed as well. (This is only possible when the Contacts are not assigned to any existing Projects/Tasks.) Show Sample PUT data

{
   "name":"ABC Ltd",
   "code":"ABC"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
code
Company Code.
  • code - Code (abbreviation of Company Name)
    Example: ABC
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
facebook
Facebook URL.
  • facebook - Facebook URL
    Example: http://www.facebook.com/proworkflow
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
imagecontent
Image.
  • imagecontent - Image Data (Base64 encoded 80x80px png image)
    IMPORTANT: An image larger than 100KB will not be added
linkedin
LinkedIn URL.
  • linkedin - LinkedIn URL
    Example: http://www.linkedin.com/proworkflow
name
Company Name.
  • name - Name
    Example: Sample Name
phone
Phone number.
  • phone - Phone number
    Example: 0123 456 7890
state
State.
  • state - State
    Example: Somewhere
twitter
Twitter URL.
  • twitter - Twitter URL
    Example: http://twitter.com/proworkflow
website
Website.
  • website - Website
    Example: www.proworkflow.com
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Contacts for a Company

This call returns a list of Contacts for a Company. The fields parameter allows you to choose which data fields to return for each Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,company,type
Fields to return, only Staff contacts view * fields.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • address
    • company
    • email*
    • groups* (Advanced plan only)
    • image
    • lastmodified
    • location* (returns latitude, longitude and locationtime - the time the location was last updated)
    • logindetails* (returns allowlogin and username)
    • name
    • phone
    • *
    • tags*
    • teams* (Advanced plan only)
    • title*
    • type
    Example: name,email,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

allowlogin
Login status.
  • true - Contacts with Login Access
  • false - Contacts without Login Access
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Contacts where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Contacts where ANY of the specified apifields match
  • all - Contacts where ALL of the specified apifields match
idfrom
Contacts with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Contacts with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Contacts added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Contacts added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Contacts added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Contacts added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Contacts
  • false - Active Contacts
search
Search string.
  • string - Contacts where Name or Email contains string
    Example: website
  • !string - Contacts where Name and Email do not contain string
    Example: !layout
searchemail
Search string.
  • string - Contacts where Email Address contains string
    Example: website
  • !string - Contacts where Email Address does not contain string
    Example: !layout
searchname
Search string.
  • string - Contacts where Name contains string
    Example: website
  • !string - Contacts where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Contacts with at least one of the specified Tag ID/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Contacts.
Example: pagenumber=2&pagesize=10 (return Contacts 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: firstname
Sort field.
  • id - Contact ID
  • firstname - Contact First Name
  • lastname - Contact Last Name
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Contact/s to a Company

This call adds one or more Contacts to a Company.
Show Sample POST data

Single Contact:
{
   "firstname":"Adam",
   "lastname":"West"
}

Multiple Contacts:
[
   {
      "firstname":"Adam",
      "lastname":"West"
   },
   {
      "firstname":"Bob",
      "lastname":"East"
   },
   {
      "firstname":"Charles",
      "lastname":"South"
   }
]

REQUIRED PARAMETERS:

firstname
First Name.
  • firstname - First Name
    Example: Adam
lastname
Last Name.
  • lastname - Last Name
    Example: West

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
allowlogin
Allow Login Access.
  • true - Grant login access
  • false - Deny login access
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
facebook
Facebook URL.
  • facebook - Facebook URL
    Example: http://www.facebook.com/proworkflow
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
groupid
Group ID or List of Group IDs. (Advanced plan only).
  • groupid/s - Group ID/s
    Example: 1,2,3
linkedin
LinkedIn URL.
  • linkedin - LinkedIn URL
    Example: http://www.linkedin.com/proworkflow
mobilephone
Mobile Phone number.
  • mobilephone - Mobile Phone Number
    Example: 0123 456 7890
password
Password (if not specified then one will be generated if allowlogin is 'true')
  • password - Password
    Example: p@55w0rd
roleid
Role ID or List of Role IDs.
  • roleid/s - Role ID/s
    Example: 1,2,3
state
State.
  • state - State
    Example: Somewhere
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
title
Job Title.
  • title - Title
    Example: CEO
twitter
Twitter URL.
  • twitter - Twitter URL
    Example: http://twitter.com/proworkflow
username
Username (contacts can also login using their email address).
  • username - Username
    Example: adam
workphone
Work Phone number.
  • workphone - Work Phone Number
    Example: 0123 456 7890
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Invoices for a Company

This call returns a list of Invoices for a Company based on the filters specified and optionally subtotals based on the grouping options specified, it also returns the totals of all the returned quotes. The subtotals parameter allows you to return Sub Totals of invoiced amounts. The fields parameter allows you to return individual Invoices and choose which data fields to return for each Invoice. This call does not return details of the individual lines for each Invoice, you can use the specific Invoice call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: number,title,company,status,projectid,invoiceddate,duedate,totals
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • company
    • dates (invoiced/due/paid)
    • description
    • duedate
    • emaileddate
    • emailedto
    • grandtotal
    • invoicedby
    • invoiceddate
    • lastmodified
    • number
    • paiddate
    • project (project id/title/number)
    • purchaseordernumber
    • status
    • subtotal
    • taxable
    • taxtotal
    • title
    • totals (sub/tax/grand totals)
    • xero (Staff only, requires Xero integration)
    Example: number,title,totals
  • none - return only Totals/Subtotals
subtotals
Sub Totals - specify required subtotals, if not specified then only Fields/Totals will be returned.
  • Comma separated list of any of the following in the required order:
    • company
    • project
    • status

    • day
    • week
    • month
    • year
    Use the 'subtotalsdateoption' to specify whether to group by invoiced, due or paid date (if week is used then the 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' date will be used as the first day of the week).
    Example: company,month - return Sub Totals of Invoiced amounts for each combination of Company and Month.
    NOTE - Only non-zero Sub Totals will be returned.
    IMPORTANT - To use date grouping options you must specify 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' depending on the option user for 'subtotalsdateoption'.

OPTIONAL PARAMETERS:

subtotalsdateoption
default: invoiced
Sub Totals Date Option - specify the date to group by when using a date option in the 'subtotals' option.
  • invoiced - Group by Invoiced Date
  • due - Group by Due Date
  • paid - Group by Paid Date

FILTER PARAMETERS:

apifields
API Field Value/s.
  • apifieldid,string - An API Field ID and String separated by a comma - Invoices where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Invoices where ANY of the specified apifields match
  • all - Invoices where ALL of the specified apifields match
duedatefrom
Invoices due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Invoices due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
grandtotal
Invoice grandtotal.
  • number - Invoice Invoice Grand Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Grand Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Grand Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
idfrom
Invoices with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Invoices with ID greater than or equal to this value .
  • id - ID
    Example: 1
invoiceddatefrom
Invoices created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
invoiceddateto
Invoices created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
lastmodifiedfrom
Invoices added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Invoices added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Invoices added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Invoices added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
paiddatefrom
Invoices paid on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
paiddateto
Invoices paid on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
searchnumber
Search string.
  • string - Invoices where Number contains string
    Example: website
  • !string - Invoices where Number does not contain string
    Example: !layout
searchtitle
Search string.
  • string - Invoices where Title contains string
    Example: website
  • !string - Invoices where Title does not contain string
    Example: !layout
status
default: unpaid
Invoice Status.
  • paid - Paid Invoices
  • unpaid - Unpaid Invoices
  • all - All Invoices
subtotal
Invoice Sub Total.
  • number - Invoice Sub Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Sub Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Sub Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
taxable
default: all
Taxable status.
  • true - Taxable Invoices
  • false - Non-Taxable Invoices
  • all - All Invoices
taxtotal
Invoice Tax Total.
  • number - Invoice Invoice Tax Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Tax Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Tax Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Invoices.
Example: pagenumber=2&pagesize=10 (return Invoices 11-20). (Paging options are not available if you are using the 'subtotals' option)
  • pagenumber
pagesize
Page Size (must be used with pagenumber). (Paging options are not available if you are using the 'subtotals' option)
  • pagesize
sortby
default: number
Sort field.
  • id - Invoice ID
  • number - Invoice Title
  • title - Invoice Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Notes for a Company

This call returns a list of Notes for a Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

search
Search string.
  • string - Notes that contain string
  • !string - Notes that do not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Notes.
Example: pagenumber=2&pagesize=10 (return Notes 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: date
Sort field.
  • id - Note ID
  • date - Note Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Note to a Company

This call adds a Note to a Company.
Show Sample POST data

{
   "content":"Example Content"
}

REQUIRED PARAMETERS:

content
Content.
  • content - Content
    Example: Sample Note

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Note from a Company

This call deletes a Note from a Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Note for a Company

This call returns a single Note for a Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Projects for a Company

This call returns a list of Projects for a Company based on the specified filters. The fields parameter allows you to choose which data fields to return for each Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,number,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • accountedfor (Accounted For Status - true/false)
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • category
    • company (for internal Projects in the Advanced plan, this will also return internalclientteamid, internalclientteamname, internalclientgroupid and internalclientgroupname)
    • completedate
    • contacts (returns clients/contractors/manager/staff)
    • customfields (Advanced plan only)
    • customform (Advanced plan only)
    • customstatus (Advanced plan only)
    • dates (returns start/due/complete)
    • description
    • duedate
    • expensestotal
    • group (Advanced plan only)
    • invoiced (Invoiced Status - true/false)
    • invoicetotal
    • lastmodified
    • manager
    • number
    • paid (Paid Status - true/false)
    • percentcomplete (percentage of tasks completed, heading tasks excluded)
    • priority
    • privatenotes (staff only)
    • quotetotal
    • startdate
    • status
    • team (Advanced plan only)
    • timeallocated
    • timetracked
    • title
    • type
    • (Advanced plan only, returns 'internal' or 'external')
    Example: number,title,company

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

accountedfor
default: all
Accounted For Status.
  • accountedfor - Projects marked as Accounted For
  • unaccountedfor - Projects marked as Unaccounted For
  • all - All Projects
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Projects where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Projects where ANY of the specified apifields match
  • all - Projects where ALL of the specified apifields match
categoryid
Category ID or List of Category IDs.
  • categoryid/s - Projects in specified Category/ies
    Example: 1,2,3
  • !categoryid/s - Projects NOT in specified Category/ies
    Example: !1,2,3
completedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Projects assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Projects NOT assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: !1,2
  • me - Projects assigned to Contact making request
  • all - All Projects
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Projects assigned to ANY of the specified contacts
  • all - Projects assigned to ALL of the specified contacts
customfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
customfieldsmode
default: any
Mode used for the customfields parameter.
  • any - Projects where ANY of the specified customfields match
  • all - Projects where ALL of the specified customfields match
customstatusid
Custom Status ID or List of Custom Status IDs (Advanced plan only).
  • customstatusid/s - Projects with specified Custom Status/es
    Example: 1,2
  • !customstatusid/s - Projects without specified Custom Status/es
    Example: !1,2
duedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
groupid
Group (Advanced plan only).
  • groupid/s - Group ID or List of Group IDs - Projects Managed by any of the specified Group/s
    Example: 1,2
  • !groupid/s - Group ID or List of Group IDs - Projects NOT Managed by any of the specified Group/s
    Example: !1,2
idfrom
Projects with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Projects with ID greater than or equal to this value .
  • id - ID
    Example: 1
invoiced
default: all
Invoiced Status.
  • invoiced - Projects marked as Invoiced
  • uninvoiced - Projects marked as Uninvoiced
  • all - All Projects
invoicetotal
Projects where Invoice Total matches criteria.
  • number - Invoice Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Invoice Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Invoice Total is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Invoice Total is GREATER THAN Quote Total (Projects with 0 Quote Total ignored)
  • under - Invoice Total is LESS THAN OR EQUAL TO Quote Total (Projects with 0 Quote Total ignored)
  • gtenumber% - Invoice Total is GREATER THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: gte30%
  • ltenumber% - Invoice Total is LESS THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: lte30%
lastmodifiedfrom
Projects added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Projects added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Projects added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Projects added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
default: all
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Projects Managed by any of the specified Contact/s
    Example: 1,2
  • !managerid/s - Contact ID or List of Contact IDs - Projects NOT Managed by any of the specified Contact/s
    Example: !1,2
  • me - Projects Managed by Contact making request
  • all - All Projects
paid
default: all
Paid Status.
  • paid - Projects marked as Paid
  • unpaid - Projects marked as Unpaid
  • all - All Projects
priority
Priority or List of Priorities (1-5 representing Very High-Very Low).
  • priority/ies - Projects with specified Priority/ies
    Example: 1,2
  • !priority/ies - Projects NOT with specified Priority/ies
    Example: !4,5
quotetotal
Projects where Quote Total matches criteria.
  • number - Quote Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Quote Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Quote Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
search
Search.
  • string - Projects where Number or Title contains string
    Example: website
  • !string - Projects where Number and Title do not contain string
    Example: !layout
searchcustomform
Search Custom Form (Advanced plan only).
  • string - Projects where Custom Form contains string
    Example: website
  • !string - Projects where Custom Form does not contain string
    Example: !layout
searchdescription
Search Description.
  • string - Projects where Description contains string
    Example: website
  • !string - Projects where Description does not contain string
    Example: !layout
searchnumber
Search Name.
  • string - Projects where Number contains string
    Example: website
  • !string - Projects where Number does not contain string
    Example: !layout
searchtitle
Search Title.
  • string - Projects where Title contains string
    Example: website
  • !string - Projects where Title does not contain string
    Example: !layout
startdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Status.
  • active - Active Projects
  • complete - Completed Projects
  • all - All Projects
teamid
Team (Advanced plan only).
  • teamid/s - Team ID or List of Team IDs - Projects Managed by any of the specified Team/s
    Example: 1,2
  • !teamid/s - Team ID or List of Team IDs - Projects NOT Managed by any of the specified Team/s
    Example: !1,2
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timebillable
default: all
Billable/Non-billable/All Time Tracked.
  • all - All Time
  • billable - Billable Time only
  • nonbillable - Non-billable Time only
timetracked
Projects where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto and timebillable parameters will apply to the starred options.
IMPORTANT: The non-starred options will always use the Total Time Tracked (all contacts, dates, billable status) for comparison.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Projects.
Example: pagenumber=2&pagesize=10 (return Projects 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: number
Sort field.
  • id - ID
  • title - Title
  • number - Number
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Project

This call adds a Project for a Company. In the Advanced Plan you may specify templateid to use a Project Template (any values you provide will override those in the Project Template). In the Advanced Plan you must specify groupid if the managerid belongs to more than 1 group.
Show Sample POST data

{
   "title":"Sample Project",
   "number":"auto",
   "description":"Sample Project Description",
   "managerid":"me",
   "staff":"2,3,5",
   "clients":"6,7",
   "contractors":"9,10",
   "priority":2,
   "startdate":"2014-04-18",
   "duedate":"2014-04-28",
   "customfields":[
      {
         "id":1,
         "value":"Europe"
      },
      {
         "id":2,
         "value":"Industrial"
      }
   ]
}

REQUIRED PARAMETERS:

title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
autonumberid
Autonumbering Option ID (Advanced Plan only, required if Advanced autonumbering is enabled and the Team of 'managerid' has more than one Autonumber option. The 'settings/projects/autonumbering' call returns a list of available IDs.).
  • autonumberid - Autonumbering Option ID
    Example: 1
categoryid
Project Category ID.
  • categoryid - Category ID
    Example: 1
clientaccess
Client Access (true/false to set whether Client can View this Project).
  • true - Client can View Project
  • false - Client cannot View Project
clients
Assigned Clients.
  • clients - Contact ID or List of Contact IDs
    Example: 1,2,3
completedate
Complete Date, if specified then the Project will be added with a Completed status (alerts are not sent when adding Completed Projects).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contractors
Assigned Contractors.
  • contractors - Contact ID or List of Contact IDs
    Example: 1,2,3
customfields
Custom Field Value/s (Advanced plan only)
  • customfields - Custom Fields
    You must specify id and value (use the settings/projects/customfields call for a list of ids and values).
    Example:
    "customfields":
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
customformcontent
Custom Form Content (Advanced plan only).
  • customformcontent - Custom Form Content
    Example: Sample Form Content
customformtitle
Custom Form Title (Advanced plan only).
  • customformtitle - Custom Form Title
    Example: Sample Form Title
customstatusid
Custom Status ID (Advanced plan only).
  • customstatusid - Custom Status ID
    Example: 1
description
Description.
  • description - Description
    Example: Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
emailalerts
Email Alerts (true/false to set whether Email Alerts are sent for activity in this Project).
  • true - Send Email Alerts
  • false - Don't Send Email Alerts
groupid
Group ID (Advanced Plan only, required if managerid belongs to more than 1 Group).
  • groupid - Group ID
    Example: 1
invoicetotal
Invoiced Value.
  • invoicetotal - Invoiced Value
    Example: 1000.00
  • auto - Total of Project Invoices
managerid
default: me
Manager ID.
  • managerid - Manager Contact ID
    Example: 1
  • me - Contact making request
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering
priority
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
privatenotes
Private Notes (Visible to Staff only).
  • privatenotes - Private Notes
    Example: Sample Private Notes
quotetotal
Quoted Value.
  • quotetotal - Quoted Value
    Example: 1000.00
  • auto - Total of Project Quotes
staff
Assigned Staff.
  • staff - Contact ID or List of Contact IDs
    Example: 1,2,3
  • me - Contact making request
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
templateid
Template ID (Advanced plan only).
  • templateid - Project Template ID
    Example: 1
timeallocated
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Quotes for a Company

This call returns a list of Quotes for a Company based on the filters specified and optionally subtotals based on the grouping options specified, it also returns the totals of all the returned quotes. The subtotals parameter allows you to return Sub Totals of quoted amounts. The fields parameter allows you to return individual Quotes and choose which data fields to return for each Quote. This call does not return details of the individual lines for each Quote, you can use the specific Quote call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: number,title,status,projectid,quoteddate,totals
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approveddate
    • company
    • dates (quoted/valid to/approved)
    • description
    • emaileddate
    • emailedto
    • lastmodified
    • number
    • project (project id/title/number)
    • quotedby
    • quoteddate
    • status
    • taxable
    • title
    • totals
    • type
    • validtodate
    Example: number,title,company
  • none - return only Totals/Subtotals
subtotals
Sub Totals - specify required subtotals, if not specified then only Fields/Totals will be returned.
  • Comma separated list of any of the following in the required order:
    • company
    • project
    • status

    • day
    • week
    • month
    • year
    Use the 'subtotalsdateoption' to specify whether to group by approved or quoted date (if week is used then the 'approveddatefrom' or 'quoteddatefrom' date will be used as the first day of the week).
    Example: company,month - return Sub Totals of Quoted amounts for each combination of Company and Month.
    NOTE - Only non-zero Sub Totals will be returned.
    IMPORTANT - To use date grouping options you must specify 'approveddatefrom' or 'quoteddatefrom' depending on the option user for 'subtotalsdateoption'.

OPTIONAL PARAMETERS:

subtotalsdateoption
default: quoted
Sub Totals Date Option - specify the date to group by when using a date option in the 'subtotals' option.
  • approved - Group by Approved Date
  • quoted - Group by Quoted Date

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Quotes where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Quotes where ANY of the specified apifields match
  • all - Quotes where ALL of the specified apifields match
approveddatefrom
Quotes approved on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
approveddateto
Quotes approved on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
grandtotal
Quote grandtotal.
  • number - Quote Grand Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Grand Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Grand Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
idfrom
Quotes with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Quotes with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Quotes added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Quotes added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Quotes added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Quotes added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
quoteddatefrom
Quotes created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
quoteddateto
Quotes created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
search
Search string.
  • string - Quotes where Number or Title contains string
    Example: website
  • !string - Quotes where Number and Title do not contain string
    Example: !layout
searchnumber
Search string.
  • string - Quotes where Number contains string
    Example: website
  • !string - Quotes where Number does not contain string
    Example: !layout
searchtitle
Search string.
  • string - Quotes where Title contains string
    Example: website
  • !string - Quotes where Title does not contain string
    Example: !layout
status
default: pending
Quote Status.
  • pending - Pending Quotes
  • approved - Approved Quotes
  • active - Pending and Approved Quotes
  • declined - Declined Quotes
  • all - All Quotes
subtotal
Quote Sub Total.
  • number - Quote Sub Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Sub Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Sub Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
taxable
default: all
Taxable status.
  • true - Taxable Quotes
  • false - Non-Taxable Quotes
  • all - All Quotes
taxtotal
Quote Tax Total.
  • number - Quote Tax Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Tax Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Tax Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
type
default: all
Quote Type.
  • estimate - Estimates
  • quote - Quotes
  • all - Estimates and Quotes
validtodatefrom
Quotes valid to/after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
validtodateto
Quotes valid to/before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Quotes.
Example: pagenumber=2&pagesize=10 (return Quotes 11-20). (Paging options are not available if you are using the 'subtotals' option)
  • pagenumber
pagesize
Page Size (must be used with pagenumber). (Paging options are not available if you are using the 'subtotals' option)
  • pagesize
sortby
default: number
Sort field.
  • id - Quote ID
  • number - Quote Title
  • title - Quote Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Company Summary

This call returns a list of Contacts, Invoices, Projects, Quotes and Tasks for the specified Company. Limited data is returned for each item and this call is not intended to replace the individual calls which offer much more extensive options.

Instead, this call is designed to be used when you need to fetch a summary of contacts and current activity for a Company.

By default this will return the first 10 results for each of the following (assuming the user has the relevant permission):

Contacts: Name, Company, Email, Phone and ID - Client/Contractor/Staff Companies
Invoices: Number, Title, Company, Totals and ID (Unpaid Invoices) - Client Companies Only
Projects: Number, Title, Company and ID (Active Projects) - Client Companies Only
Quotes: Number, Title, Company, Totals and ID (Pending Quotes) - Client Companies Only
Tasks: Name, Order, Project and ID (Active Tasks) - Client Companies Only

REQUIRED PARAMETERS:

FIELD PARAMETERS:

types
default: all
Data Types to return.
  • all - Return all data types
  • Comma separated list of any of the following:
    • contacts
    • invoices
    • projects
    • quotes
    • tasks
    Example: contacts,projects

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

pagenumber
default: 1
Page Number (must be used with pagesize) to return a subset of each Data Type.
Example: pagenumber=2&pagesize=10 (return rows 11-20).
  • pagenumber
pagesize
default: 10
Page Size (must be used with pagenumber).
  • pagesize
Staff
Client
Contractor
View Tags for a Company

This call returns a list of tags for a Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add/Remove Tags for a Company

This call adds or removes tags for a Company.

REQUIRED PARAMETERS:

tagid
Tags to Add/Remove.
  • tags - Tag ID or List of Tag IDs
    Example: 1,2,3

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

remove
default: false
Set as 'true' to remove Tags (default is to add them).
  • true - Remove Tags from Company
  • false - Add Tags to Company

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Tasks for a Company

This call returns a list of Tasks for a Company based on the specified filters. The fields parameter allows you to choose which data fields to return for each Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,type,order,status,project,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • billable
    • category
    • company
    • completedate
    • contacts
    • creator
    • (contact who added this Task)
    • dates (returns start/due/complete)
    • dependent (returns currenttask status and prerequisites)
    • description
    • duedate
    • lastmodified
    • name
    • order
    • priority
    • project
    • (returns ID/Number/Title)
    • projectcategory
    • (returns ID/Name)
    • projectmanager
    • (returns ID/Name)
    • startdate
    • status
    • timeallocated
    • timetracked
    • type
    Example: order,name,project

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Tasks where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Tasks where ANY of the specified apifields match
  • all - Tasks where ALL of the specified apifields match
billable
default: all
Billable status.
  • true - Billable Tasks
  • false - Non-Billable Tasks
  • all - All Tasks
categoryid
Category.
  • categoryid/s - General Tasks in specified Category/ies
    Example: 1,2
  • !categoryid/s - General Tasks NOT in specified Category/ies
    Example: !1,2
completedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Tasks assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • me - Tasks assigned to Contact making request
  • unassigned - Unassigned Tasks
  • all - All Tasks
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Tasks assigned to ANY of the specified contacts
  • all - Tasks assigned to ALL of the specified contacts
dependentstatus
default: all
Task Dependent Status.
  • current - Current Tasks
  • noncurrent - Non-Current Tasks
  • all - All Tasks
duedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
generaltasks
default: true
General Tasks.
  • true - Include General Tasks
  • false - Exclude General Tasks
idfrom
Tasks with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Tasks with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Tasks added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Tasks added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Tasks in Projects managed by specified Contact/s
    Example: 1,2
  • me - Tasks in Projects managed by Contact making request
priority
Priority (1-5 representing Very High-Very Low).
  • priority/ies - Tasks with specified Priority/ies
    Example: 1,2
  • !priority/ies - Tasks NOT with specified Priority/ies
    Example: !4,5
projectcategoryid
Project Category ID or List of Project Category IDs.
  • projectcategoryid/s - Tasks in Projects in specified Category/ies
    Example: 1,2,3
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project.
  • projectid/s - Tasks in specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstatus
default: all
Project Status.
  • active - Tasks in Active Projects
  • complete - Tasks in Completed Projects
  • all - Tasks in All Projects
projecttasks
default: true
Project Tasks.
  • true - Include Project Tasks
  • false - Exclude Project Tasks
searchdescription
Search Description.
  • string - Tasks where Description contains string
    Example: website
  • !string - Tasks where Description does not contain string
    Example: !layout
searchname
Search Name.
  • string - Tasks where Name contains string
    Example: website
  • !string - Tasks where Name does not contain string
    Example: !layout
startdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Task Status.
  • active - Active Tasks
  • complete - Completed Tasks
  • all - All Tasks
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timetracked
Tasks where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto parameters apply to the starred options.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
type
default: all
Task Type.
  • normal - Normal Tasks
  • bold - Bold Tasks
  • heading - Heading Tasks
  • nonheading - Non-Heading Tasks (Normal + Bold)
  • all - All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Tasks.
Example: pagenumber=2&pagesize=10 (return Tasks 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - ID
  • order - Order
  • name - Name
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • projectid - Project ID
  • projectnumber - Project Number
  • projecttitle - Project Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Time Tracked by a Contact

This call returns a the Total time tracked by a Contact based on the filters specified. The subtotals parameter allows you to return Sub Totals of time tracked. The fields parameter allows you to return individual Time Records and choose which data fields to return for each Time Record.

REQUIRED PARAMETERS:

trackedfrom
default: -6d
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
trackedto
default: +0d
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FIELD PARAMETERS:

fields
Fields to return - if not specified then only Total/Sub Totals will be returned.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approvalstatus
    • billable
    • category (Project Category)
    • company
    • contact
    • dates
    • lastmodified
    • notes
    • project
    • task
    • tasktimetotals (Total allocated/tracked time for the task)
    • timetracked
    Example: contact,task,timetracked
  • none - return only Total/Subtotals
subtotals
Sub Totals to return - if not specified then only Fields and/or Total will be returned.
  • Comma separated list of any of the following in the required order:
    • billable
    • category
    • company
    • contact
    • group (Advanced plan only, Group in charge of Project)
    • internalclientgroup (Advanced plan only, Group of Internal Client for Project)
    • internalclientteam (Advanced plan only, Team of Internal Client for Project)
    • project
    • task
    • team (Advanced plan only, Team in charge of Project)

    • day
    • week
    • month
    • year
    • If week is used then the 'trackedfrom' date will be used as the first day of the week.
      Example: contact,company - return Sub Totals of Time Tracked for each combination of Contact and Company.
      NOTE - Only non-zero Sub Totals will be returned.

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Time Records where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Time Records where ANY of the specified apifields match
  • all - Time Records where ALL of the specified apifields match
approvalstatus
default: all
Approval Status.
  • approved - Approved Time Records
  • locked - Locked Time Records
  • submitted - Submitted Time Records
  • open - Open Time Records (Not approved, locked or submitted)
  • closed - Closed Time Records (Approved, locked or submitted)
  • all - All Time Records
billable
default: all
Billable status.
  • billable - Billable Time
  • nonbillable - Non-Billable Time
  • all - All Time
categoryid
Project Category ID or List of Project Category IDs.
  • categoryid/s - Time for Projects in specified Category/ies
    Example: 1,2
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • me - Time Tracked by Contact making request
  • all - Time Tracked by All Contact
generaltasks
default: true
General Tasks.
  • true - Include Time for General Tasks
  • false - Exclude Time for General Tasks
idfrom
Time Records with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Time Records with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Time Records added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Time Records added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Time Records added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Time Records added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project ID or List of Project IDs.
  • projectid/s - Time for specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projecttasks
default: true
Project Tasks.
  • true - Include Time for Project Tasks
  • false - Exclude Time for Project Tasks
taskcompletedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskcompletedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskid
Task ID or List of Task IDs.
  • taskid/s - Time for specified Task/s
    Example: 1,2
taskstartdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskstartdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

sortby
default: id
Sort field for Time Records.
  • id - Time Record ID
  • date - Time Record Date
  • taskid - Task ID
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Client Companies

This call returns a list of Client Companies based on the specified filters. The fields parameter allows you to choose which data fields to return for each Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,code
Fields to return.
  • Comma separated list of any of the following:
    • address
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • code
    • contacts
    • email
    • image
    • lastmodified
    • name
    • phone
    • tags
    • type
    Example: code,name,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Companies where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Companies where ANY of the specified apifields match
  • all - Companies where ALL of the specified apifields match
divisionid
Division ID (Advanced plan only).
  • divisionid - Companies in specified Division
    Example: 1
idfrom
Companies with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Companies with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Companies added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Companies added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Companies added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Companies added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Companies
  • false - Active Companies
search
Search string.
  • string - Companies where Name or Code contains string
    Example: website
  • !string - Companies where Name and Code do not contain string
    Example: !layout
searchcode
Search string.
  • string - Companies where Code contains string
    Example: website
  • !string - Companies where Code does not contain string
    Example: !layout
searchemail
Search string.
  • string - Companies where Email contains string
    Example: website
  • !string - Companies where Email does not contain string
    Example: !layout
searchname
Search string.
  • string - Companies where Name contains string
    Example: website
  • !string - Companies where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Companies with at least one of the specified Tag ID/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Companies.
Example: pagenumber=2&pagesize=10 (return Companies 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - Company ID
  • name - Company Name
  • code - Company Code
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Contractor Companies

This call returns a list of Contractor Companies based on the specified filters. The fields parameter allows you to choose which data fields to return for each Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,code
Fields to return.
  • Comma separated list of any of the following:
    • address
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • code
    • contacts
    • email
    • image
    • lastmodified
    • name
    • phone
    • tags
    • type
    Example: code,name,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Companies where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Companies where ANY of the specified apifields match
  • all - Companies where ALL of the specified apifields match
divisionid
Division ID (Advanced plan only).
  • divisionid - Companies in specified Division
    Example: 1
idfrom
Companies with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Companies with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Companies added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Companies added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Companies added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Companies added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Companies
  • false - Active Companies
search
Search string.
  • string - Companies where Name or Code contains string
    Example: website
  • !string - Companies where Name and Code do not contain string
    Example: !layout
searchcode
Search string.
  • string - Companies where Code contains string
    Example: website
  • !string - Companies where Code does not contain string
    Example: !layout
searchemail
Search string.
  • string - Companies where Email contains string
    Example: website
  • !string - Companies where Email does not contain string
    Example: !layout
searchname
Search string.
  • string - Companies where Name contains string
    Example: website
  • !string - Companies where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Companies with at least one of the specified Tag ID/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Companies.
Example: pagenumber=2&pagesize=10 (return Companies 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - Company ID
  • name - Company Name
  • code - Company Code
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Staff Companies

This call returns a list of Staff Companies. The fields parameter allows you to choose which data fields to return for each Company.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,code
Fields to return.
  • Comma separated list of any of the following:
    • address
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • code
    • contacts
    • email
    • image
    • lastmodified
    • name
    • phone
    • tags
    • type
    Example: code,name,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Companies where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Companies where ANY of the specified apifields match
  • all - Companies where ALL of the specified apifields match
divisionid
Division ID (Advanced plan only).
  • divisionid - Companies in specified Division
    Example: 1
idfrom
Companies with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Companies with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Companies added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Companies added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Companies added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Companies added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Companies
  • false - Active Companies
search
Search string.
  • string - Companies where Name or Code contains string
    Example: website
  • !string - Companies where Name and Code do not contain string
    Example: !layout
searchcode
Search string.
  • string - Companies where Code contains string
    Example: website
  • !string - Companies where Code does not contain string
    Example: !layout
searchemail
Search string.
  • string - Companies where Email contains string
    Example: website
  • !string - Companies where Email does not contain string
    Example: !layout
searchname
Search string.
  • string - Companies where Name contains string
    Example: website
  • !string - Companies where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Companies with at least one of the specified Tag ID/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Companies.
Example: pagenumber=2&pagesize=10 (return Companies 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - Company ID
  • name - Company Name
  • code - Company Code
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending

DELETE PUT POST GET

Staff
Client
Contractor
View Contacts

This call returns a list of Contacts based on the filters specified. The fields parameter allows you to choose which data fields to return for each Contact. Clients can only view limited details about Staff and Contacts in their Company. Contractors can only view limited details about Staff and themselves.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,company,type
Fields to return, only Staff contacts view * fields.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • address
    • company
    • email*
    • fax*
    • groups* (Advanced plan only)
    • image
    • lastmodified
    • location* (returns latitude, longitude and locationtime - the time the location was last updated)
    • logindetails* (returns allowlogin and username)
    • name
    • phone*
    • roles
    • (returns roles for Staff Contacts)
    • tags*
    • teams* (Advanced plan only)
    • title*
    • type
    Example: name,email,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

allowlogin
Login status.
  • true - Contacts with Login Access
  • false - Contacts without Login Access
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Contacts where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Contacts where ANY of the specified apifields match
  • all - Contacts where ALL of the specified apifields match
companyid
Company ID.
  • companyid - Contacts in specified Company
    Example: 1
divisionid
Division ID (Advanced plan only).
  • divisionid - Contacts in specified Division
    Example: 1
id
List of Contact IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Contacts with ID less than or equal to this value.
  • id - ID
    Example: 1
idto
Contacts with ID greater than or equal to this value.
  • id - ID
    Example: 1
lastmodifiedfrom
Contacts added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Contacts added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Contacts added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Contacts added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Contacts
  • false - Active Contacts
roleid
Role ID or List of Role IDs.
  • roleid/s - Contacts with at least one of the specified Role ID/s
    Example: 1,2,3
search
Search string.
  • string - Contacts where Name or Email contains string
    Example: website
  • !string - Contacts where Name and Email do not contain string
    Example: !layout
searchemail
Search string.
  • string - Contacts where Email Address contains string
    Example: website
  • !string - Contacts where Email Address does not contain string
    Example: !layout
searchname
Search string.
  • string - Contacts where Name contains string
    Example: website
  • !string - Contacts where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Contacts with at least one of the specified Tag ID/s
    Example: 1,2,3
type
Contact Type.
  • client - Client Contacts
  • contractor - Contractor Contacts
  • other - Other Contacts
  • staff - Staff Contacts

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Contacts.
Example: pagenumber=2&pagesize=10 (return Contacts 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: firstname
Sort field.
  • id - Contact ID
  • firstname - Contact First Name
  • lastname - Contact Last Name
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Contact/s.

This call adds one or more Contacts.
Show Sample POST data

Single Contact:
{
   "firstname":"Adam",
   "lastname":"West",
   "type":"client",
   "companyid":1
}

Multiple Contacts:
[
   {
      "firstname":"Adam",
      "lastname":"West",
      "type":"client",
      "companyid":1
   },
   {
      "firstname":"Bob",
      "lastname":"East",
      "type":"client",
      "companyid":2
   },
   {
      "firstname":"Charles",
      "lastname":"South",
      "type":"contractor",
      "companyid":3
   }
]

REQUIRED PARAMETERS:

companyid
Company ID.
  • companyid - Company ID
    Example: 1
firstname
First Name.
  • firstname - First Name
    Example: Adam
lastname
Last Name.
  • lastname - Last Name
    Example: West
type
Contact Type.
  • staff - Staff Contact
  • client - Client Contact
  • contractor - Contractor Contact
  • other - Other Contact

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

addprojectrequest
default: false
Client can add a project request (only applies in Advanced plan for clients).
  • true - Grant permission
  • false - Deny permission
address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
allowlogin
Allow Login Access.
  • true - Grant login access
  • false - Deny login access
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
facebook
Facebook URL.
  • facebook - Facebook URL
    Example: http://www.facebook.com/proworkflow
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
groupid
Group ID or List of Group IDs. (Staff Contacts in Advanced Plan only)
IMPORTANT: If a Group ID/s is not specified then Staff will be automatically added to Group ID 1.
  • groupid/s - Group ID/s
    Example: 1,2,3
imagecontent
Image.
  • imagecontent - Image Data (Base64 encoded 80x80px png image)
    IMPORTANT: Not available when adding multiple contacts, an image larger than 100KB will not be added
linkedin
LinkedIn URL.
  • linkedin - LinkedIn URL
    Example: http://www.linkedin.com/proworkflow
mobilephone
Mobile Phone number.
  • mobilephone - Mobile Phone Number
    Example: 0123 456 7890
password
Password (if not specified then one will be generated if allowlogin is 'true')
  • password - Password
    Example: p@55w0rd
roleid
Role ID or List of Role IDs (Staff Contacts with Login Access only)
IMPORTANT: If a Role ID/s is not specified then Staff will be automatically setup as Super Users if allowlogin is 'true'.
  • roleid/s - Role ID/s
    Example: 1,2,3
state
State.
  • state - State
    Example: Somewhere
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
title
Job Title.
  • title - Title
    Example: CEO
twitter
Twitter URL.
  • twitter - Twitter URL
    Example: http://twitter.com/proworkflow
username
Username (contacts can also login using their email address).
  • username - Username
    Example: adam
viewallcompanyprojects
default: false
Client can view all company projects (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewallprojecttasks
default: false
Client can view all project tasks (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewarchivedprojects
default: false
Client can view archived projects (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewcalendar
default: false
Client can view calendar page (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewquotesandinvoices
default: false
Client can view quotes and invoices (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewtimeinformation
default: false
Client can view time information (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewtimeline
default: false
Client can view timeline (only applies for clients).
  • true - Grant permission
  • false - Deny permission
workphone
Work Phone number.
  • workphone - Work Phone Number
    Example: 0123 456 7890
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Contact

This call deletes a Contact, historic information will be preserved, if you need to delete historic information then please delete the contact in the main PWF application.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Contact

This call returns details of a single Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

permissions
default: false
Contact Permissions.
  • true - Return roles & permissions (for staff) or include permissions (for clients & contractors)
  • false - Do not return roles & permissions

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Contact

This call updates a single Contact.
Show Sample PUT data

{
   "firstname":"Adam",
   "lastname":"West"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

addprojectrequest
Client can add a project request (only applies in Advanced plan for clients).
  • true - Grant permission
  • false - Deny permission
address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
allowlogin
Allow Login Access.
  • true - Grant login access
  • false - Deny login access
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
companyid
Company ID.
  • companyid - Company ID
    Example: 1
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
facebook
Facebook URL.
  • facebook - Facebook URL
    Example: http://www.facebook.com/proworkflow
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
firstname
First Name.
  • firstname - First Name
    Example: Adam
groupid
Group ID or List of Group IDs. (Staff Contacts in Advanced Plan only)
  • groupid/s - Group ID/s
    Example: 1,2,3
imagecontent
Image.
  • imagecontent - Image Data (Base64 encoded 80x80px png image)
    IMPORTANT: An image larger than 100KB will not be added
lastname
Last Name.
  • lastname - Last Name
    Example: West
linkedin
LinkedIn URL.
  • linkedin - LinkedIn URL
    Example: http://www.linkedin.com/proworkflow
mobilephone
Mobile Phone Number.
  • mobilephone - Mobile Phone Number
    Example: 0123 456 7890
password
Password (if none is provided then one will be randomly generated if allowlogin is 'true')
  • password - Password
    Example: p@55w0rd
roleid
Role ID or List of Role IDs (Staff Contacts with Login Access only)
  • roleid/s - Role ID/s
    Example: 1,2,3
state
State.
  • state - State
    Example: Somewhere
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
title
Job Title.
  • title - Title
    Example: CEO
twitter
Twitter URL.
  • twitter - Twitter URL
    Example: http://twitter.com/proworkflow
username
Username (contacts can also login using their email address).
  • username - Username
    Example: adam
viewallcompanyprojects
Client can view all company projects (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewallprojecttasks
Client can view all project tasks (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewarchivedprojects
Client can view archived projects (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewcalendar
Client can view calendar page (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewquotesandinvoices
Client can view quotes and invoices (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewtimeinformation
Client can view time information (only applies for clients).
  • true - Grant permission
  • false - Deny permission
viewtimeline
Client can view timeline (only applies for clients).
  • true - Grant permission
  • false - Deny permission
workphone
Work Phone Number.
  • workphone - Work Phone Number
    Example: 0123 456 7890
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Groups for a Staff Contact

This call returns a list of Teams & Groups for a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add/Remove Staff Contact to/from a Group

This call adds or removes a Contact to/from a Group. Team membership will be automatically updated.

REQUIRED PARAMETERS:

groupid
Groups to Add/Remove Contact to/from.
  • groupds - Group ID or List of Group IDs
    Example: 1,2,3

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

remove
default: false
Set as 'true' to remove from Groups (default is to add to them).
  • true - Remove Contact from Group/s
  • false - Add Contact to Group/s

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Contact's Location

This call returns latitude, longitude and locationtime (when the location was last updated) of a single Contact's Location.
IMPORTANT: Location is not the same as a Contact's Address. Location is used when you need to track a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Update a Contact's Location

This call updates the location of a single Contact, you can specify either Latitude/Longitude OR an Address to be geocoded (converted to a latitude/longitude), an error will be returned if the geocoding fails.
Show Sample POST data

{
   "latitude":43.689060,
   "longitude":-20.182721
}

REQUIRED PARAMETERS:

address
Address
  • address - Address
    Example: 123 ABC Street, Townsville, 91911, USA
latitude
Latitude
  • latitude - Latitude
    Example: 40.689060
longitude
Longitude
  • longitude - Longitude
    Example: -20.182721

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Notes for a Contact

This call returns a list of Notes for a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

datefrom
Notes added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Notes added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
search
Search string.
  • string - Notes that contain string
    Example: website
  • !string - Notes that do not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Notes.
Example: pagenumber=2&pagesize=10 (return Notes 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: date
Sort field.
  • id - Note ID
  • date - Note Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Note to a Contact

This call adds a Note to a Contact.
Show Sample POST data

{
   "content":"Example Content"
}

REQUIRED PARAMETERS:

content
Content.
  • content - Content
    Example: Note Content

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Note from a Contact

This call deletes a Note from a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Note for a Contact

This call returns a single Note for a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View All Permissions for a Contact

This call returns all permissions for a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Check Permission

This call checks a single permission for a Staff contact, use the 'settings/contacts/permissions' call to view a list of permissionids.

REQUIRED PARAMETERS:

permissionsetting
default: view
Permission Setting to check.
  • view - View
  • add - Add
  • edit - Edit
  • delete - Delete

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Projects for a Contact

This call returns a list of Projects for a Contact based on the specified filters. The fields parameter allows you to choose which data fields to return for each Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,number,company,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • accountedfor (Accounted For Status - true/false)
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • category
    • company (for internal Projects in the Advanced plan, this will also return internalclientteamid, internalclientteamname, internalclientgroupid and internalclientgroupname)
    • completedate
    • contacts (returns clients/contractors/manager/staff)
    • customfields (Advanced plan only)
    • customform (Advanced plan only)
    • customstatus (Advanced plan only)
    • dates (returns start/due/complete)
    • description
    • duedate
    • expensestotal
    • group (Advanced plan only)
    • invoiced (Invoiced Status - true/false)
    • invoicetotal
    • lastmodified
    • manager
    • number
    • paid (Paid Status - true/false)
    • percentcomplete (percentage of tasks completed, heading tasks excluded)
    • priority
    • privatenotes (staff only)
    • quotetotal
    • startdate
    • status
    • team (Advanced plan only)
    • timeallocated
    • timetracked
    • title
    • type
    • (Advanced plan only, returns 'internal' or 'external')
    Example: number,title,company

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

accountedfor
default: all
Accounted For Status.
  • accountedfor - Projects marked as Accounted For
  • unaccountedfor - Projects marked as Unaccounted For
  • all - All Projects
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Projects where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Projects where ANY of the specified apifields match
  • all - Projects where ALL of the specified apifields match
categoryid
Category ID or List of Category IDs.
  • categoryid/s - Projects in specified Category/ies
    Example: 1,2,3
  • !categoryid/s - Projects NOT in specified Category/ies
    Example: !1,2,3
completedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
customfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
customfieldsmode
default: any
Mode used for the customfields parameter.
  • any - Projects where ANY of the specified customfields match
  • all - Projects where ALL of the specified customfields match
customstatusid
Custom Status ID or List of Custom Status IDs (Advanced plan only).
  • customstatusid/s - Projects with specified Custom Status/es
    Example: 1,2
  • !customstatusid/s - Projects without specified Custom Status/es
    Example: !1,2
duedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
groupid
Group (Advanced plan only).
  • groupid/s - Group ID or List of Group IDs - Projects Managed by any of the specified Group/s
    Example: 1,2
  • !groupid/s - Group ID or List of Group IDs - Projects NOT Managed by any of the specified Group/s
    Example: !1,2
idfrom
Projects with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Projects with ID greater than or equal to this value .
  • id - ID
    Example: 1
invoiced
default: all
Invoiced Status.
  • invoiced - Projects marked as Invoiced
  • uninvoiced - Projects marked as Uninvoiced
  • all - All Projects
invoicetotal
Projects where Invoice Total matches criteria.
  • number - Invoice Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Invoice Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Invoice Total is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Invoice Total is GREATER THAN Quote Total (Projects with 0 Quote Total ignored)
  • under - Invoice Total is LESS THAN OR EQUAL TO Quote Total (Projects with 0 Quote Total ignored)
  • gtenumber% - Invoice Total is GREATER THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: gte30%
  • ltenumber% - Invoice Total is LESS THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: lte30%
lastmodifiedfrom
Projects added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Projects added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Projects added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Projects added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
default: all
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Projects Managed by any of the specified Contact/s
    Example: 1,2
  • !managerid/s - Contact ID or List of Contact IDs - Projects NOT Managed by any of the specified Contact/s
    Example: !1,2
  • me - Projects Managed by Contact making request
  • all - All Projects
paid
default: all
Paid Status.
  • paid - Projects marked as Paid
  • unpaid - Projects marked as Unpaid
  • all - All Projects
priority
Priority or List of Priorities (1-5 representing Very High-Very Low).
  • priority/ies - Projects with specified Priority/ies
    Example: 1,2
  • !priority/ies - Projects NOT with specified Priority/ies
    Example: !4,5
quotetotal
Projects where Quote Total matches criteria.
  • number - Quote Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Quote Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Quote Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
search
Search.
  • string - Projects where Number or Title contains string
    Example: website
  • !string - Projects where Number and Title do not contain string
    Example: !layout
searchcustomform
Search Custom Form (Advanced plan only).
  • string - Projects where Custom Form contains string
    Example: website
  • !string - Projects where Custom Form does not contain string
    Example: !layout
searchdescription
Search Description.
  • string - Projects where Description contains string
    Example: website
  • !string - Projects where Description does not contain string
    Example: !layout
searchnumber
Search Name.
  • string - Projects where Number contains string
    Example: website
  • !string - Projects where Number does not contain string
    Example: !layout
searchtitle
Search Title.
  • string - Projects where Title contains string
    Example: website
  • !string - Projects where Title does not contain string
    Example: !layout
startdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Status.
  • active - Active Projects
  • complete - Completed Projects
  • all - All Projects
teamid
Team (Advanced plan only).
  • teamid/s - Team ID or List of Team IDs - Projects Managed by any of the specified Team/s
    Example: 1,2
  • !teamid/s - Team ID or List of Team IDs - Projects NOT Managed by any of the specified Team/s
    Example: !1,2
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timebillable
default: all
Billable/Non-billable/All Time Tracked.
  • all - All Time
  • billable - Billable Time only
  • nonbillable - Non-billable Time only
timetracked
Projects where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto and timebillable parameters will apply to the starred options.
IMPORTANT: The non-starred options will always use the Total Time Tracked (all contacts, dates, billable status) for comparison.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Projects.
Example: pagenumber=2&pagesize=10 (return Projects 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: number
Sort field.
  • id - ID
  • title - Title
  • number - Number
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Project

This call adds a Project for a Contact. In the Advanced Plan you may specify templateid to use a Project Template (any values you provide will override those in the Project Template). In the Advanced Plan you must specify groupid if the managerid belongs to more than 1 group.
Show Sample POST data

{
   "title":"Sample Project",
   "number":"auto",
   "description":"Sample Project Description",
   "managerid":"me",
   "staff":"2,3,5",
   "clients":"6,7",
   "contractors":"9,10",
   "priority":2,
   "startdate":"2014-04-18",
   "duedate":"2014-04-28",
   "customfields":
   [
      {
         "id":1,
         "value":"Europe"
      },
      {
         "id":2,
         "value":"Industrial"
      }
   ]
}

REQUIRED PARAMETERS:

title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
autonumberid
Autonumbering Option ID (Advanced Plan only, required if Advanced autonumbering is enabled and the Team of 'managerid' has more than one Autonumber option. The 'settings/projects/autonumbering' call returns a list of available IDs.).
  • autonumberid - Autonumbering Option ID
    Example: 1
categoryid
Project Category ID.
  • categoryid - Category ID
    Example: 1
clientaccess
Client Access (true/false to set whether Client can View this Project).
  • true - Client can View Project
  • false - Client cannot View Project
clients
Assigned Clients.
  • clients - Contact ID or List of Contact IDs
    Example: 1,2,3
completedate
Complete Date, if specified then the Project will be added with a Completed status (alerts are not sent when adding Completed Projects).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contractors
Assigned Contractors.
  • contractors - Contact ID or List of Contact IDs
    Example: 1,2,3
customfields
Custom Field Value/s (Advanced plan only)
  • customfields - Custom Fields
    You must specify id and value (use the settings/projects/customfields call for a list of ids and values).
    Example:
    "customfields":
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
customformcontent
Custom Form Content (Advanced plan only).
  • customformcontent - Custom Form Content
    Example: Sample Form Content
customformtitle
Custom Form Title (Advanced plan only).
  • customformtitle - Custom Form Title
    Example: Sample Form Title
customstatusid
Custom Status ID (Advanced plan only).
  • customstatusid - Custom Status ID
    Example: 1
description
Description.
  • description - Description
    Example: Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
emailalerts
Email Alerts (true/false to set whether Email Alerts are sent for activity in this Project).
  • true - Send Email Alerts
  • false - Don't Send Email Alerts
groupid
Group ID (Advanced Plan only, required if managerid belongs to more than 1 Group).
  • groupid - Group ID
    Example: 1
invoicetotal
Invoiced Value.
  • invoicetotal - Invoiced Value
    Example: 1000.00
  • auto - Total of Project Invoices
managerid
default: me
Manager ID.
  • managerid - Manager Contact ID
    Example: 1
  • me - Contact making request
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering
priority
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
privatenotes
Private Notes (Visible to Staff only).
  • privatenotes - Private Notes
    Example: Sample Private Notes
quotetotal
Quoted Value.
  • quotetotal - Quoted Value
    Example: 1000.00
  • auto - Total of Project Quotes
staff
Assigned Staff.
  • staff - Contact ID or List of Contact IDs
    Example: 1,2,3
  • me - Contact making request
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
templateid
Template ID (Advanced plan only).
  • templateid - Project Template ID
    Example: 1
timeallocated
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Roles for a Staff Contact

This call returns a list of roles for a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add/Remove Roles for a Staff Contact

This call adds or removes roles for a Contact.

REQUIRED PARAMETERS:

roleid
Roles to Add/Remove.
  • roles - Role ID or List of Role IDs
    Example: 1,2,3

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

remove
default: false
Set as 'true' to remove Roles (default is to add them).
  • true - Remove Roles from Contact
  • false - Add Roles to Contact

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Contact Summary

This call returns a list of Contacts, Invoices, Projects, Quotes and Tasks for the specified Contact. Limited data is returned for each item and this call is not intended to replace the individual calls which offer much more extensive options.

Instead, this call is designed to be used when you need to fetch a summary of current activity for a Contact.

By default this will return the first 10 results for each of the following (assuming the user has the relevant permission):

Projects: Number, Title, Company and ID (Active Projects)
Tasks: Name, Order, Project and ID (Active Tasks)

REQUIRED PARAMETERS:

FIELD PARAMETERS:

types
default: all
Data Types to return.
  • all - Return all data types
  • Comma separated list of any of the following:
    • projects
    • tasks
    Example: contacts,projects

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

pagenumber
default: 1
Page Number (must be used with pagesize) to return a subset of each Data Type.
Example: pagenumber=2&pagesize=10 (return rows 11-20).
  • pagenumber
pagesize
default: 10
Page Size (must be used with pagenumber).
  • pagesize
Staff
Client
Contractor
View Tags for a Contact

This call returns a list of tags for a Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add/Remove Tags for a Contact

This call adds or removes tags for a Contact.

REQUIRED PARAMETERS:

tagid
Tags to Add/Remove.
  • tags - Tag ID or List of Tag IDs
    Example: 1,2,3

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

remove
default: false
Set as 'true' to remove Tags (default is to add them).
  • true - Remove Tags from Contact
  • false - Add Tags to Contact

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Tasks for a Contact

This call returns a list of Tasks for a Contact based on the specified filters. The fields parameter allows you to choose which data fields to return for each Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,type,order,status,project,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • billable
    • category
    • company
    • completedate
    • contacts
    • creator
    • (contact who added this Task)
    • dates (returns start/due/complete)
    • dependent (returns currenttask status and prerequisites)
    • description
    • duedate
    • lastmodified
    • name
    • order
    • priority
    • project
    • (returns ID/Number/Title)
    • projectcategory
    • (returns ID/Name)
    • projectmanager
    • (returns ID/Name)
    • startdate
    • status
    • timeallocated
    • timetracked
    • type
    Example: order,name,project

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Tasks where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Tasks where ANY of the specified apifields match
  • all - Tasks where ALL of the specified apifields match
billable
default: all
Billable status.
  • true - Billable Tasks
  • false - Non-Billable Tasks
  • all - All Tasks
categoryid
Category.
  • categoryid/s - General Tasks in specified Category/ies
    Example: 1,2
  • !categoryid/s - General Tasks NOT in specified Category/ies
    Example: !1,2
companyid
Company.
  • companyid/s - Company ID or List of Company IDs - Tasks in Projects for specified Company/ies
    Example: 1,2
completedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dependentstatus
default: all
Task Dependent Status.
  • current - Current Tasks
  • noncurrent - Non-Current Tasks
  • all - All Tasks
divisionid
Division ID (Advanced plan only).
  • divisionid - Tasks in specified Division
    Example: 1
duedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
generaltasks
default: true
General Tasks.
  • true - Include General Tasks
  • false - Exclude General Tasks
idfrom
Tasks with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Tasks with ID greater than or equal to this value .
  • id - ID
    Example: 1
internalclientgroupid
Group ID or List of Group IDs.
  • groupid/s - Tasks for specified Group/s
    Example: 1,2,3
internalclientteamid
Team ID or List of Team IDs.
  • companyid/s - Tasks for specified Team/s
    Example: 1,2,3
lastmodifiedfrom
Tasks added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Tasks added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Tasks added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Tasks added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Tasks in Projects managed by specified Contact/s
    Example: 1,2
  • me - Tasks in Projects managed by Contact making request
priority
Priority (1-5 representing Very High-Very Low).
  • priority/ies - Tasks with specified Priority/ies
    Example: 1,2
  • !priority/ies - Tasks NOT with specified Priority/ies
    Example: !4,5
projectcategoryid
Project Category ID or List of Project Category IDs.
  • projectcategoryid/s - Tasks in Projects in specified Category/ies
    Example: 1,2,3
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project.
  • projectid/s - Tasks in specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstatus
default: all
Project Status.
  • active - Tasks in Active Projects
  • complete - Tasks in Completed Projects
  • all - Tasks in All Projects
projecttasks
default: true
Project Tasks.
  • true - Include Project Tasks
  • false - Exclude Project Tasks
searchdescription
Search Description.
  • string - Tasks where Description contains string
    Example: website
  • !string - Tasks where Description does not contain string
    Example: !layout
searchname
Search Name.
  • string - Tasks where Name contains string
    Example: website
  • !string - Tasks where Name does not contain string
    Example: !layout
startdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Task Status.
  • active - Active Tasks
  • complete - Completed Tasks
  • all - All Tasks
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timetracked
Tasks where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto parameters apply to the starred options.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
type
default: all
Task Type.
  • normal - Normal Tasks
  • bold - Bold Tasks
  • heading - Heading Tasks
  • nonheading - Non-Heading Tasks (Normal + Bold)
  • all - All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Tasks.
Example: pagenumber=2&pagesize=10 (return Tasks 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - ID
  • order - Order
  • name - Name
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • projectid - Project ID
  • projectnumber - Project Number
  • projecttitle - Project Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Time Tracked by a Contact

This call returns a the Total time tracked by a Contact based on the filters specified. The subtotals parameter allows you to return Sub Totals of time tracked. The fields parameter allows you to return individual Time Records and choose which data fields to return for each Time Record.

REQUIRED PARAMETERS:

trackedfrom
default: -6d
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
trackedto
default: +0d
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FIELD PARAMETERS:

fields
Fields to return - if not specified then only Total/Sub Totals will be returned.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approvalstatus
    • billable
    • category (Project Category)
    • company
    • contact
    • dates
    • lastmodified
    • notes
    • project
    • task
    • tasktimetotals (Total allocated/tracked time for the task)
    • timetracked
    Example: contact,task,timetracked
  • none - return only Total/Subtotals
subtotals
Sub Totals to return - if not specified then only Fields and/or Total will be returned.
  • Comma separated list of any of the following in the required order:
    • billable
    • category
    • company
    • contact
    • group (Advanced plan only, Group in charge of Project)
    • internalclientgroup (Advanced plan only, Group of Internal Client for Project)
    • internalclientteam (Advanced plan only, Team of Internal Client for Project)
    • project
    • task
    • team (Advanced plan only, Team in charge of Project)

    • day
    • week
    • month
    • year
    • If week is used then the 'trackedfrom' date will be used as the first day of the week.
      Example: contact,company - return Sub Totals of Time Tracked for each combination of Contact and Company.
      NOTE - Only non-zero Sub Totals will be returned.

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma (Example: 2,Europe) - Time Records where the field contains the specified string
  • Multiple API Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Time Records where ANY of the specified apifields match
  • all - Time Records where ALL of the specified apifields match
approvalstatus
default: all
Approval Status.
  • approved - Approved Time Records
  • locked - Locked Time Records
  • submitted - Submitted Time Records
  • open - Open Time Records (Not approved, locked or submitted)
  • closed - Closed Time Records (Approved, locked or submitted)
  • all - All Time Records
billable
default: all
Billable status.
  • billable - Billable Time
  • nonbillable - Non-Billable Time
  • all - All Time
categoryid
Project Category ID or List of Project Category IDs.
  • categoryid/s - Time for Projects in specified Category/ies
    Example: 1,2
companyid
Company ID or List of Company IDs.
  • companyid/s - Time in specified Company/ies
    Example: 1,2,3
generaltasks
default: true
General Tasks.
  • true - Include Time for General Tasks
  • false - Exclude Time for General Tasks
idfrom
Time Records with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Time Records with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Time Records added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Time Records added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Time Records added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Time Records added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project ID or List of Project IDs.
  • projectid/s - Time for specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projecttasks
default: true
Project Tasks.
  • true - Include Time for Project Tasks
  • false - Exclude Time for Project Tasks
taskcompletedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskcompletedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskid
Task ID or List of Task IDs.
  • taskid/s - Time for specified Task/s
    Example: 1,2
taskstartdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskstartdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

sortby
default: id
Sort field for Time Records.
  • id - Time Record ID
  • date - Time Record Date
  • taskid - Task ID
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Client Contacts

This call returns a list of Client Contacts based on the specified filters. The fields parameter allows you to choose which data fields to return for each Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,company,type
Fields to return, only Staff contacts view * fields.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • address
    • company
    • email*
    • groups* (Advanced plan only)
    • image
    • lastmodified
    • location* (returns latitude, longitude and locationtime - the time the location was last updated)
    • logindetails* (returns allowlogin and username)
    • name
    • phone*
    • tags*
    • teams* (Advanced plan only)
    • title*
    • type
    Example: name,email,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

allowlogin
Login status.
  • true - Contacts with Login Access
  • false - Contacts without Login Access
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Contacts where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Contacts where ANY of the specified apifields match
  • all - Contacts where ALL of the specified apifields match
companyid
Company ID.
  • companyid - Contacts in specified Company
    Example: 1
divisionid
Division ID (Advanced plan only).
  • divisionid - Contacts in specified Division
    Example: 1
idfrom
Contacts with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Contacts with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Contacts added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Contacts added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Contacts added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Contacts added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Contacts
  • false - Active Contacts
search
Search string.
  • string - Contacts where Name or Email contains string
    Example: website
  • !string - Contacts where Name and Email do not contain string
    Example: !layout
searchemail
Search string.
  • string - Contacts where Email Address contains string
    Example: website
  • !string - Contacts where Email Address does not contain string
    Example: !layout
searchname
Search string.
  • string - Contacts where Name contains string
    Example: website
  • !string - Contacts where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Contacts with at least one of the specified Tag ID/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Contacts.
Example: pagenumber=2&pagesize=10 (return Contacts 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: firstname
Sort field.
  • id - Contact ID
  • firstname - Contact First Name
  • lastname - Contact Last Name
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Contractor Contacts

This call returns a list of Contractor Contacts based on the specified filters. The fields parameter allows you to choose which data fields to return for each Contact.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,company,type
Fields to return, only Staff contacts view * fields.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • address
    • company
    • email*
    • groups* (Advanced plan only)
    • image
    • lastmodified
    • location* (returns latitude, longitude and locationtime - the time the location was last updated)
    • logindetails* (returns allowlogin and username)
    • name
    • phone*
    • tags*
    • teams* (Advanced plan only)
    • title*
    • type
    Example: name,email,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

allowlogin
Login status.
  • true - Contacts with Login Access
  • false - Contacts without Login Access
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Contacts where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Contacts where ANY of the specified apifields match
  • all - Contacts where ALL of the specified apifields match
companyid
Company ID.
  • companyid - Contacts in specified Company
    Example: 1
divisionid
Division ID (Advanced plan only).
  • divisionid - Contacts in specified Division
    Example: 1
idfrom
Contacts with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Contacts with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Contacts added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Contacts added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Contacts added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Contacts added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Contacts
  • false - Active Contacts
search
Search string.
  • string - Contacts where Name or Email contains string
    Example: website
  • !string - Contacts where Name and Email do not contain string
    Example: !layout
searchemail
Search string.
  • string - Contacts where Email Address contains string
    Example: website
  • !string - Contacts where Email Address does not contain string
    Example: !layout
searchname
Search string.
  • string - Contacts where Name contains string
    Example: website
  • !string - Contacts where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Contacts with at least one of the specified Tag ID/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Contacts.
Example: pagenumber=2&pagesize=10 (return Contacts 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: firstname
Sort field.
  • id - Contact ID
  • firstname - Contact First Name
  • lastname - Contact Last Name
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Request Password Reset

This call sends an email to supplied address with details on how to reset their password.
If no matching address is found, this will return a 404 response code

REQUIRED PARAMETERS:

email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Contacts' Locations

This call returns latitude, longitude and locationtime (when the location was last updated) of all Contacts.
IMPORTANT: Location is not the same as a Contact's Address. Location is used when you need to track a Contact. Contacts who have never updated their location will not be returned.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Contacts in specified Division
    Example: 1
locationtimefrom
Contacts who updated their location on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
locationtimeto
Contacts who updated their location on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Request Access to ProWorkflow.

This call adds one or more Contacts.
IMPORTANT: Advanced Plan Only - Contact/Company will be added to Division ID 1.
Show Sample POST data

{
   "firstname":"Adam",
   "lastname":"West",
   "email":"noreply@proworkflow.com",
   "type":"client",
   "companyname":"ABC"
}

REQUIRED PARAMETERS:

companyname
Company Name (required unless 'type' is 'staff').
  • companyname - Company Name
    Example: ABC
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
firstname
First Name.
  • firstname - First Name
    Example: Adam
lastname
Last Name.
  • lastname - Last Name
    Example: West
type
default: client
Contact Type.
  • staff - Staff Contact
  • client - Client Contact
  • contractor - Contractor Contact

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Staff Contacts

This call returns a list of Staff Contacts based on the specified filters. The fields parameter allows you to choose which data fields to return for each Contact. Clients & Contractors can only view limited details about Staff.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,company,type
Fields to return, only Staff contacts view * fields.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • address
    • company
    • email*
    • groups* (Advanced plan only)
    • image
    • lastmodified
    • location* (returns latitude, longitude and locationtime - the time the location was last updated)
    • logindetails* (returns allowlogin and username)
    • name
    • phone*
    • tags*
    • teams* (Advanced plan only)
    • title*
    • type
    Example: name,email,phone

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

allowlogin
Login status.
  • true - Contacts with Login Access
  • false - Contacts without Login Access
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Contacts where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Contacts where ANY of the specified apifields match
  • all - Contacts where ALL of the specified apifields match
companyid
Company ID.
  • companyid - Contacts in specified Company
    Example: 1
divisionid
Division ID (Advanced plan only).
  • divisionid - Contacts in specified Division
    Example: 1
idfrom
Contacts with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Contacts with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Contacts added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Contacts added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Contacts added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Contacts added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
pending
default: false
Pending status.
  • true - Pending Contacts
  • false - Active Contacts
roleid
Role ID or List of Role IDs.
  • roleid/s - Contacts with at least one of the specified Role ID/s
    Example: 1,2,3
search
Search string.
  • string - Contacts where Name or Email contains string
    Example: website
  • !string - Contacts where Name and Email do not contain string
    Example: !layout
searchemail
Search string.
  • string - Contacts where Email Address contains string
    Example: website
  • !string - Contacts where Email Address does not contain string
    Example: !layout
searchname
Search string.
  • string - Contacts where Name contains string
    Example: website
  • !string - Contacts where Name does not contain string
    Example: !layout
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Contacts with at least one of the specified Tag ID/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Contacts.
Example: pagenumber=2&pagesize=10 (return Contacts 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: firstname
Sort field.
  • id - Contact ID
  • firstname - Contact First Name
  • lastname - Contact Last Name
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending

DELETE PUT POST GET

Staff
Client
Contractor
View Events

This call returns a list of Events based on the filters specified. The fields parameter allows you to choose which data fields to return for each Event.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,description,times,contacts
Fields to return.
  • Comma separated list of any of the following:
    • contacts
    • description
    • endtime
    • lastmodified
    • starttime
    • times (start and end time)
    • title
    Example: title,description,times

OPTIONAL PARAMETERS:

contactdetails
default: false
Contact Details.
  • true - Return email, image, phone for contacts
  • false - Do not return email, image, phone for contacts

FILTER PARAMETERS:

contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Events assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • me - Events assigned to Contact making request
  • all - All Events
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Events assigned to ANY of the specified contacts
  • all - Events assigned to ALL of the specified contacts
divisionid
Division ID (Advanced plan only).
  • divisionid - Events in specified Division
    Example: 1
endtimefrom
Events ending on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
endtimeto
Events ending on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
id
List of Event IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Events with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Events with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Events added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Events added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Events added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Events added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
searchdescription
Search Description.
  • string - Events where Description contains string
    Example: website
  • !string - Events where Description does not contain string
    Example: !layout
searchtitle
Search Title.
  • string - Events where Title contains string
    Example: website
  • !string - Events where Title does not contain string
    Example: !layout
starttimefrom
Events starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
starttimeto
Events starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Events.
Example: pagenumber=2&pagesize=10 (return Events 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field for Events.
  • id - Event ID
  • title - Event Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add an Event

This call adds a single Event.
Show Sample POST data

{
   "contacts":"1,2",
   "title":"New Event",
   "description":"Event Description",
   "starttime":"2014-03-20T13:00",
   "endtime":"2014-03-20T14:00"
}

REQUIRED PARAMETERS:

contacts
default: me
Assigned Staff Contacts.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Staff
endtime
End Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
starttime
Start Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

description
Description.
  • description - Description
    Example: Sample Description

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete an Event

This call deletes a single Event.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View an Event

This call returns details of a single Event.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit an Event

This call updates a single Event.
Show Sample PUT data

{
   "contacts":"1,2",
   "title":"New Event",
   "description":"Event Description",
   "starttime":"2014-03-20T13:00",
   "endtime":"2014-03-20T14:00"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

contacts
Contacts.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Staff
description
Description.
  • description - Description
    Example: Sample Description
endtime
End Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
starttime
Start Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
title
Title.
  • title - Title
    Example: Sample title

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

DELETE PUT POST GET

Staff
Client
Contractor
View Expenses

This call returns a list of Expenses based on the filters specified. The fields parameter allows you to choose which data fields to return for each Expense.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,description,cost,project,date
Fields to return.
  • Comma separated list of any of the following:
    • company
    • contact
    • cost
    • date
    • description
    • invoiced
    • name
    • project(includes id/number/title)
    • taxable
    Example: name,cost,date

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

categoryid
Project Category ID or List of Project Category IDs.
  • categoryid/s - Expenses for Projects in specified Category/ies
    Example: 1,2
companyid
Company ID or List of Company IDs.
  • companyid/s - Expenses for specified Company/ies
    Example: 1,2,3
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Expenses for specified Contact/s
    Example: 1,2
  • me - Expenses for Contact making request
  • all - Expenses for All Contacts
datefrom
Expenses added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Expenses added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
divisionid
Division ID (Advanced plan only).
  • divisionid - Expenses in specified Division
    Example: 1
id
List of Expense IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Expenses with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Expenses with ID greater than or equal to this value .
  • id - ID
    Example: 1
invoiced
default: all
Invoiced status.
  • invoiced - Invoiced Expenses
  • uninvoiced - Uninvoiced Expenses
  • all - All Expenses
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Expenses for specified Project/s
    Example: 1,2
projectstatus
default: active
Project Completion Status.
  • active - Expenses for Active Projects
  • complete - Expenses for Completed Projects
  • all - Expenses for All Projects
search
Search string.
  • string - Expenses where Name contains string
    Example: website
  • !string - Expenses where Name does not contain string
    Example: !layout
taxable
default: all
Taxable status.
  • taxable - Taxable Expenses
  • nontaxable - Non-Taxable Expenses
  • all - All Expenses

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Expenses.
Example: pagenumber=2&pagesize=10 (return Expenses 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: date
Sort field.
  • id - Expense ID
  • name - Expense Name
  • date - Expense Date
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add an Expense

This call adds a single Expense.
Show Sample POST data

{
   "projectid":1,
   "name":"New Expense",
   "description":"Event Description",
   "date":"2014-03-28",
   "cost":100.00
}

REQUIRED PARAMETERS:

cost
Cost of Expense.
  • cost - Cost
    Example: 500.00
name
Name.
  • name - Name
    Example: Sample Name
projectid
Project ID.
  • projectid - Project ID

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

date
Date of Expense.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
description
Description.
  • description - Description
    Example: Sample Description
invoiced
default: false
Invoiced status.
  • true - Invoiced
  • false - Uninvoiced
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete an Expense

This call deletes a single Expense.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View an Expense

This call returns details of a single Expense.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit an Expense

This call updates a single Expense.
Show Sample PUT data

{
   "date":"2014-03-28",
   "cost":100.00
   "invoiced":true
}

REQUIRED PARAMETERS:

cost
Cost of Expense.
  • cost - Cost
    Example: 500.00
name
Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

date
Date of Expense.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
description
Description.
  • description - Description
    Example: Sample Description
invoiced
Invoiced status.
  • true - Invoiced
  • false - Uninvoiced
taxable
Taxable status.
  • true - Taxable
  • false - Non-Taxable

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

DELETE PUT POST GET

Staff
Client
Contractor
View Files

This call returns a list of Files based on the filters specified. The fields parameter allows you to choose which data fields to return for each File.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,project,task,date,size,link
Fields to return.
  • Comma separated list of any of the following:
    • contacts (returns 'all' if File is public, returns array of contacts if File is private)
    • date
    • folder (includes id,name)
    • link
    • name
    • project (includes id/number/title)
    • size
    • task (includes id/name)
    Example: name,size,link

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

datefrom
Files added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Files added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
divisionid
Division ID (Advanced plan only).
  • divisionid - Files in specified Division
    Example: 1
folderid
Folder ID or List of Folder IDs.
  • folderid/s - Folder ID or List of Folder IDs - Files in specified Folder/s
    Example: 1,2
id
List of File IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Files with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Files with ID greater than or equal to this value .
  • id - ID
    Example: 1
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Files for specified Project/s
    Example: 1,2
projectstatus
default: active
Project Status.
  • active - Files for Active Projects
  • complete - Files for Completed Projects
  • all - Files for All Projects
search
Search string.
  • string - Files where Name contains string
    Example: website
  • !string - Files where Name does not contain string
    Example: !layout
taskid
Task ID or List of Task IDs.
  • taskid/s - Task ID or List of Task IDs - Files for specified Task/s
    Example: 1,2
taskstatus
default: all
Task Status.
  • active - Files for Active Tasks
  • complete - Files for Completed Tasks
  • all - Files for All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Files.
Example: pagenumber=2&pagesize=10 (return Files 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - File ID
  • name - File Name
  • size - File Size
  • date - File Date
  • projectid - Project ID
  • taskid - Task ID
  • folderid - Folder ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a File

This call adds a single File.
Show Sample POST data

{
   "projectid":1,
   "name":"filename.txt",
   "content":"U29tZSB0ZXh0"
}

REQUIRED PARAMETERS:

content
Base64-encoded content.
  • content - Name
    Example: U29tZSB0ZXh0
folderid
Folder ID (Exactly 1 of Project/Task/Folder Required).
  • folderid - Folder ID
    Example: 1
name
Name.
  • name - Name
    Example: Sample Name
projectid
Project or Project Request ID (Exactly 1 of Project/Task/Folder Required).
  • projectid - Project or Project Request ID
    Example: 1
taskid
Task ID (Exactly 1 of Project/Task/Folder Required).
  • taskid - Task ID
    Example: 1

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a File

This call returns deletes a single File.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a File

This call returns details of a single File.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

content
default: false
Return Base64 Encoded Content
Important: Not available for files larger than 1MB
  • true - Return 'content' field
  • false - Do not return 'content' field

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Custom Folders

This call returns a list of Custom Folders based on the filters specified. The fields parameter allows you to choose which data fields to return for each Custom Folder.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,project,contacts
Fields to return.
  • Comma separated list of any of the following:
    • contacts (returns 'all' if Folder is public, returns array of contacts if Folder is private)
    • name
    • project (includes id/number/title)
      • Example: name,contacts

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Folders in specified Division
    Example: 1
id
List of Folder IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Folders with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Folders with ID greater than or equal to this value .
  • id - ID
    Example: 1
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Folders for specified Project/s
    Example: 1,2
projectstatus
default: active
Project Status.
  • active - Folders for Active Projects
  • complete - Folders for Completed Projects
  • all - Folders for All Projects
search
Search string.
  • string - Folders where Name contains string
    Example: website
  • !string - Folders where Name does not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Folders.
Example: pagenumber=2&pagesize=10 (return Folders 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - Folder ID
  • name - Folder Name
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Custom Folder

This call adds a single Custom Folder.
Show Sample POST data

{
   "projectid":1,
   "name":"New Folder",
   "contacts":"1,2,3"
}

REQUIRED PARAMETERS:

contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Add Private Folder for specified Contact/s
    Example: 1,2,3
  • me - Add Private Folder for Contact making request
  • all - Add Public Folder
name
Name.
  • name - Name
    Example: Sample Name
projectid
Project ID.
  • projectid - Project ID
    Example: 1

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Custom Folder

This call returns details of a single Custom Folder.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

DELETE PUT POST GET

Staff
Client
Contractor
View Invoices/Totals

This call returns a list of Invoices based on the filters specified and optionally subtotals based on the grouping options specified, it also returns the totals of all the returned quotes. The subtotals parameter allows you to return Sub Totals of invoiced amounts. The fields parameter allows you to return individual Invoices and choose which data fields to return for each Invoice. This call does not return details of the individual lines for each Invoice, you can use the specific Invoice call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: number,title,company,status,totals,projectid,invoiceddate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • company
    • customfield (returns customfieldname and customfieldvalue)
    • dates (invoiced/due/paid)
    • description
    • duedate
    • emaileddate
    • emailedto
    • invoicedby
    • invoiceddate
    • lastmodified
    • number
    • paiddate
    • project (project id/title/number)
    • purchaseordernumber
    • showcostbreakdown
    • status
    • taxable
    • taxrate
    • title
    • totals (sub/tax/grand totals)
    Example: number,title,totals
  • none - return only Totals/Subtotals
subtotals
Sub Totals - specify required subtotals, if not specified then only Fields/Totals will be returned.
  • Comma separated list of any of the following in the required order:
    • company
    • project
    • status

    • day
    • week
    • month
    • year
    Use the 'subtotalsdateoption' to specify whether to group by invoiced, due or paid date (if week is used then the 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' date will be used as the first day of the week).
    Example: company,month - return Sub Totals of Invoiced amounts for each combination of Company and Month.
    NOTE - Only non-zero Sub Totals will be returned.
    IMPORTANT - To use date grouping options you must specify 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' depending on the option user for 'subtotalsdateoption'.

OPTIONAL PARAMETERS:

subtotalsdateoption
default: invoiced
Sub Totals Date Option - specify the date to group by when using a date option in the 'subtotals' option.
  • invoiced - Group by Invoiced Date
  • due - Group by Due Date
  • paid - Group by Paid Date

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Invoices where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Invoices where ANY of the specified apifields match
  • all - Invoices where ALL of the specified apifields match
companyid
Company ID or List of Company IDs.
  • companyid/s - Invoices in specified Company/ies
    Example: 1,2,3
divisionid
Division ID (Advanced plan only).
  • divisionid - Invoices in specified Division
    Example: 1
duedatefrom
Invoices due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Invoices due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
grandtotal
Invoice grandtotal.
  • number - Invoice Invoice Grand Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Grand Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Grand Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
id
List of Invoice IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Invoices with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Invoices with ID greater than or equal to this value .
  • id - ID
    Example: 1
invoiceddatefrom
Invoices created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
invoiceddateto
Invoices created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
lastmodifiedfrom
Invoices added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Invoices added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Invoices added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Invoices added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Invoices in Projects managed by specified Contact/s
    Example: 1,2
  • me - Invoices in Projects managed by Contact making request
paiddatefrom
Invoices paid on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
paiddateto
Invoices paid on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcategoryid
Project Category ID or List of Project Category IDs.
  • projectcategoryid/s - Invoices in Projects in specified Category/ies
    Example: 1,2,3
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Invoices for specified Project/s
    Example: 1,2
projectstatus
default: all
Project Status.
  • active - Invoices in Active Projects
  • complete - Invoices in Completed Projects
  • all - Invoices in All Projects
search
Search string.
  • string - Invoices where Number or Title contains string
    Example: website
  • !string - Invoices where Number and Title do not contain string
    Example: !layout
searchnumber
Search string.
  • string - Invoices where Number contains string
    Example: website
  • !string - Invoices where Number does not contain string
    Example: !layout
searchtitle
Search string.
  • string - Invoices where Title contains string
    Example: website
  • !string - Invoices where Title does not contain string
    Example: !layout
status
default: unpaid
Invoice Status.
  • paid - Paid Invoices
  • unpaid - Unpaid Invoices
  • all - All Invoices
subtotal
Invoice Sub Total.
  • number - Invoice Sub Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Sub Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Sub Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
taxable
default: all
Taxable status.
  • true - Taxable Invoices
  • false - Non-Taxable Invoices
  • all - All Invoices
taxtotal
Invoice Tax Total.
  • number - Invoice Invoice Tax Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Tax Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Tax Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Invoices.
Example: pagenumber=2&pagesize=10 (return Invoices 11-20). (Paging options are not available if you are using the 'subtotals' option)
  • pagenumber
pagesize
Page Size (must be used with pagenumber). (Paging options are not available if you are using the 'subtotals' option)
  • pagesize
sortby
default: number
Sort field.
  • companyname - Company Name
  • duedate - Due Date
  • id - Invoice ID
  • invoiceddate - Invoiced Date
  • number - Invoice Number
  • title - Invoice Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add an Invoice

This call adds a simple Invoice..
Show Sample POST data

{
   "title":"New Invoice",
   "number":"auto",
   "description":"Invoice Description",
   "contactid":1,
   "projectid":2,
   "lines":
   [
      {
         "type":"heading",
         "name":"Redesign Work"
      },
      {
         "type":"lineitem",
         "name":"Line Item 1",
         "quantity":1,
         "rate":100.00,
         "taxable":true
      },
      {
         "type":"taskrate",
         "name":"Task Rate",
         "time":60,
         "rate":100.00,
         "taxable":false
      },
      {
         "type":"staffrate",
         "name":"Alex Trip",
         "time":60,
         "rate":100.00,
         "taxable":false
      }
   ]
}

REQUIRED PARAMETERS:

companyid
Client Company ID.
  • companyid - Company ID
    Example: 1
contactid
Client Contact ID.
  • contactid - Contact ID
    Example: 1
lines
Line/s.
  • lines - Line/s

    The 'type' must be specified, the following must then be specified depending on the 'type':
    • 'heading' - Must provide 'name'
    • 'expense' - Must provide 'name' as well as 'quantity' & 'rate'
    • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
    • 'staffrate' - Must provide 'name', 'time' & 'rate'
    • 'taskrate' - Must provide 'name', 'time' & 'rate'
    Example:
    [
       {
          "type":"heading",
          "name":"Redesign Work"
       },
       {
          "type":"lineitem",
          "name":"Line Item 1",
          "name":"Line Item 1 Description",
          "quantity":1,
          "rate":100.00,
          "taxable":true
       },
       {
          "type":"taskrate",
          "name":"Task Rate",
          "time":60,
          "rate":100.00,
          "taxable":false
       },
       {
          "type":"staffrate",
          "name":"Alex Trip",
          "time":60,
          "rate":100.00,
          "taxable":false
       }
    ]
projectid
Project ID.
  • projectid - Attach Invoice to Project ID
    Example: 1
title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
companyname
Address Company Name.
  • companyname - Address Line 2
    Example: ABC Ltd
contactname
Address Contact Name.
  • contactname - Address Line 1
    Example: Amy Adams
country
Country.
  • country - Country
    Example: Someland
description
Description.
  • description - Description
    Example: Sample Description
discountdescription
default: Discount
Discount Description.
  • discountdescription - Discount Description
    Example: Sample Discount
discountvalue
Discount Value.
  • number - Apply a Fixed Value Discount
    Example: 500
  • number% - Apply a percentage Discount
    Example: 10%
duedate
Due Date (if not specified then this will be calculated automatically from Invoiced Date and default payment settings).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
footer
Footer.
  • footer - footer
    Example: Sample footer
invoiceddate
Invoiced Date (defaults to current date)
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
markprojectasinvoiced
default: false
Mark Project as Invoiced.
  • true - Project will be set as invoiced
  • false - Project will not be updated
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering
purchaseordernumber
Purchase Order Number.
  • purchaseordernumber - Purchase Order Number
    Example: PO-1234
showcostbreakdown
default: true
Show Cost Breakdown (in main application).
  • true - Show Cost Breakdown
  • false - Hide Cost Breakdown
state
State.
  • state - State
    Example: Somewhere
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable
taxrate
Tax rate (overrides default rate).
  • number - Tax Rate (%)
    Example: 12.5
terms
Terms.
  • terms - Terms
    Example: Valid for 14 Days
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete an Invoice

This call deletes a single Invoice.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View an Invoice

This call returns details of a single Invoice.
IMPORTANT: For Task/Staff Rate Lines, the 'rate' value is cost/hour, the 'time' value is the time in minutes.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit an Invoice

This call updates details of a single Invoice.
IMPORTANT: If you specify any 'lines' then all existing lines will be replaced, if you want to add/edit/remove individual lines then use the dedicated 'invoice/lines' or 'invoice/line' calls instead.
Show Sample PUT data

{
   "status":"paid",
   "discountvalue":100,
   "discountdescription":"Discount Description",
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
companyname
Address Company Name.
  • companyname - Address Line 2
    Example: ABC Ltd
contactname
Address Contact Name.
  • contactname - Address Line 1
    Example: Amy Adams
country
Country.
  • country - Country
    Example: Someland
description
Description.
  • description - Description
    Example: Sample Description
discountdescription
Discount Description.
  • discountdescription - Discount Description
    Example: Sample Discount
discountvalue
Discount Value.
  • number - Apply a Fixed Value Discount
    Example: 500
  • number% - Apply a percentage Discount
    Example: 10%
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
footer
Footer.
  • footer - Footer
    Example: Sample footer
invoiceddate
Invoiced Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
lines
Line/s.
  • lines - Line/s

    The 'type' must be specified, the following must then be specified depending on the 'type':
    • 'heading' - Must provide 'name'
    • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
    • 'staffrate' - Must provide 'name', 'time' & 'rate'
    • 'taskrate' - Must provide 'name', 'time' & 'rate'
    Example:
    [
       {
          "type":"heading",
          "name":"Redesign Work"
       },
       {
          "type":"lineitem",
          "name":"Line Item 1",
          "name":"Line Item 1 Description",
          "quantity":1,
          "rate":100.00,
          "taxable":true
       },
       {
          "type":"taskrate",
          "name":"Task Rate",
          "time":60,
          "rate":100.00,
          "taxable":false
       },
       {
          "type":"staffrate",
          "name":"Alex Trip",
          "time":60,
          "rate":100.00,
          "taxable":false
       }
    ]
number
Number.
  • number - Number
    Example: ABC-00001
paiddate
Paid Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project ID.
  • projectid - Attach Invoice to Project ID
    Example: 1
purchaseordernumber
Purchase Order Number.
  • purchaseordernumber - Purchase Order Number
    Example: PO-1234
showcostbreakdown
Show Cost Breakdown (in main application).
  • true - Show Cost Breakdown
  • false - Hide Cost Breakdown
state
State.
  • state - State
    Example: Somewhere
status
Status.
  • unpaid - Unpaid
  • paid - Paid
taxable
Taxable status.
  • true - Taxable
  • false - Non-Taxable
taxrate
Tax rate.
  • number - Tax Rate (%)
    Example: 12.5
title
Title.
  • title - Title
    Example: Sample title
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Line Items in an Invoice

This call returns details of Line Items in an Invoice.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add Line/s to an Invoice

This call adds Line/s to an Invoice.

The 'type' must be specified, the following must then be specified depending on the 'type':

  • 'heading' - Must provide 'name'
  • 'expense' - Must provide 'name' as well as 'quantity' & 'rate'
  • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
  • 'staffrate' - Must provide 'name', 'time' & 'rate'
  • 'taskrate' - Must provide 'name', 'time' & 'rate'

Show Sample POST data

Single Line Item:
{
   "type":"lineitem",
   "name":"Line Item 1",
   "description":"Line Item 1 Description",
   "quantity":1,
   "rate":100.00,
   "taxable":true
}

Multiple Line Items:
[
   {
      "type":"heading",
      "name":"Redesign Work"
   },
   {
      "type":"lineitem",
      "name":"Line Item 1",
      "quantity":1,
      "rate":100.00,
      "taxable":true
   },
   {
      "type":"taskrate",
      "name":"Task Rate",
      "time":60,
      "rate":100.00,
      "taxable":false
   },
   {
      "type":"staffrate",
      "name":"Alex Trip",
      "time":60,
      "rate":100.00,
      "taxable":false
   }
]

REQUIRED PARAMETERS:

type
Type.
  • heading - Heading
  • lineitem - Line Item
  • staffrate - Staff Rate
  • taskrate - Task Rate

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

description
Description.
  • description - Description
    Example: Sample Description
displayorder
default: auto
Display Order
  • auto - Add as last Lines.
  • afterlineid - Add after 'lineid' in Invoice. Any existing Lines will be reordered automatically.
    Example: after1
  • beforelineid - Add before 'lineid' in Invoice. Any existing Tasks will be reordered automatically.
    Example: before1
  • number - Add Line with display order number 'number'.
    IMPORTANT: This option will NOT reorder any existing lines.
    Example: 1.1
name
Name.
  • name - Name
    Example: Sample name
quantity
Quantity.
  • quantity - Rate
    Example: 5
rate
Rate.
  • rate - Rate
    Example: 500.00
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable
time
Time (minutes).
  • time - Rate
    Example: 120

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Line from an Invoice

This call delete a single Line in an Invoice.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Line in an Invoice

This call returns details of a single Line in an Invoice.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Line in an Invoice

This call updates a single Line in an Invoice.
Show Sample PUT data

{
   "rate":100.00,
   "taxable":false
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

description
Description.
  • description - Description
    Example: Sample Description
displayorder
Display Order
  • number - Update Line with display order number 'number'.
    IMPORTANT: This option will NOT reorder any existing lines.
    Example: 1.1
name
Name.
  • name - Name
    Example: Sample name
quantity
Quantity.
  • quantity - Rate
    Example: 5
rate
Rate.
  • rate - Rate
    Example: 500.00
taxable
Taxable status.
  • true - Taxable
  • false - Non-Taxable
time
Time (minutes).
  • time - Rate
    Example: 120

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Mark an Invoice as Paid

This call will mark a single Invoice as paid. You can specify 'paiddate' otherwise the current user's time is used.
Show Sample PUT data

{
   "paiddate":"2014-04-28"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

paiddate
Paid Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Mark an Invoice as Unpaid

This call will mark a single Invoice as unpaid.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Overdue Invoices

This call returns a list of overdue Invoices based on the filters specified and optionally subtotals based on the grouping options specified, it also returns the totals of all the returned quotes. The subtotals parameter allows you to return Sub Totals of invoiced amounts. The fields parameter allows you to return individual Invoices and choose which data fields to return for each Invoice. This call does not return details of the individual lines for each Invoice, you can use the specific Invoice call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: number,title,company,projectid,invoiceddate,duedate,totals
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • company
    • dates (invoiced/due/paid)
    • duedate
    • emaileddate
    • emailedto
    • grandtotal
    • invoicedby
    • invoiceddate
    • lastmodified
    • number
    • paiddate
    • project (project id/title/number)
    • purchaseordernumber
    • status
    • subtotal
    • taxable
    • taxtotal
    • title
    • totals (sub/tax/grand totals)
    • xero (Staff only, requires Xero integration)
    Example: number,title,totals
  • none - return only Totals/Subtotals
subtotals
Sub Totals - specify required subtotals, if not specified then only Fields/Totals will be returned.
  • Comma separated list of any of the following in the required order:
    • company
    • project
    • status

    • day
    • week
    • month
    • year
    Use the 'subtotalsdateoption' to specify whether to group by invoiced, due or paid date (if week is used then the 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' date will be used as the first day of the week).
    Example: company,month - return Sub Totals of Invoiced amounts for each combination of Company and Month.
    NOTE - Only non-zero Sub Totals will be returned.
    IMPORTANT - To use date grouping options you must specify 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' depending on the option user for 'subtotalsdateoption'.

OPTIONAL PARAMETERS:

subtotalsdateoption
default: invoiced
Sub Totals Date Option - specify the date to group by when using a date option in the 'subtotals' option.
  • invoiced - Group by Invoiced Date
  • due - Group by Due Date
  • paid - Group by Paid Date

FILTER PARAMETERS:

apifields
API Field Value/s.
  • apifieldid,string - An API Field ID and String separated by a comma - Invoices where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Invoices where ANY of the specified apifields match
  • all - Invoices where ALL of the specified apifields match
companyid
Company ID or List of Company IDs.
  • companyid/s - Invoices in specified Company/ies
    Example: 1,2,3
divisionid
Division ID (Advanced plan only).
  • divisionid - Invoices in specified Division
    Example: 1
grandtotal
Invoice grandtotal.
  • number - Invoice Invoice Grand Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Grand Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Grand Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
idfrom
Invoices with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Invoices with ID greater than or equal to this value .
  • id - ID
    Example: 1
invoiceddatefrom
Invoices created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
invoiceddateto
Invoices created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
lastmodifiedfrom
Invoices added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Invoices added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Invoices added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Invoices added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Invoices for specified Project/s
    Example: 1,2
search
Search string.
  • string - Invoices where Number or Title contains string
    Example: website
  • !string - Invoices where Number and Title do not contain string
    Example: !layout
searchnumber
Search string.
  • string - Invoices where Number contains string
    Example: website
  • !string - Invoices where Number does not contain string
    Example: !layout
searchtitle
Search string.
  • string - Invoices where Title contains string
    Example: website
  • !string - Invoices where Title does not contain string
    Example: !layout
subtotal
Invoice Sub Total.
  • number - Invoice Sub Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Sub Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Sub Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
taxable
default: all
Taxable status.
  • true - Taxable Invoices
  • false - Non-Taxable Invoices
  • all - All Invoices
taxtotal
Invoice Tax Total.
  • number - Invoice Invoice Tax Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Tax Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Tax Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Invoices.
Example: pagenumber=2&pagesize=10 (return Invoices 11-20). (Paging options are not available if you are using the 'subtotals' option)
  • pagenumber
pagesize
Page Size (must be used with pagenumber). (Paging options are not available if you are using the 'subtotals' option)
  • pagesize
sortby
default: number
Sort field.
  • id - Invoice ID
  • number - Invoice Title
  • title - Invoice Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending

DELETE PUT POST GET

Staff
Client
Contractor
Login Call

returns details about the user making the request and the account they are accessing. If you don't know your API key then you can use this call to return it by providing your Account URL (as well as using a Basic Authorization header).

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

url
Account URL.
  • string - Account URL
    Example: https://proworkflow6.net/ABCInc

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Contact Information

This call returns details of the Contact making the request.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit Contact Information

This call updatesthe Contact making the request.
Show Sample PUT data

{
   "firstname":"Adam",
   "lastname":"West"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3
  • address3 - Address Line 3
    Example: Pretend Town
city
City
  • city - City
    Example: Somecity
country
Country
  • country - Country
    Example: Someland
email
Email Address
  • email - Email Address
    Example: noreply@proworkflow.com
firstname
First Name
  • firstname - First Name
    Example: Adam
lastname
Last Name
  • lastname - Last Name
    Example: West
mobilephone
Mobile Phone Number.
  • mobilephone - Mobile Phone Number
    Example: 0123 456 7890
password
Password
  • password - Password
    Example: p@55w0rd
state
State
  • state - State
    Example: Somewhere
title
Job Title
  • title - Title
    Example: CEO
username
Username
  • username - Username
    Example: adam
workphone
Work Phone Number
  • workphone - Work Phone Number
    Example: 0123 456 7890
zipcode
Zipcode
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

DELETE PUT POST GET

Staff
Client
Contractor
View Messages

This call returns a list of Messages based on the filters specified. The fields parameter allows you to choose which data fields to return for each Message.
IMPORTANT: We recommend using the datefrom option to return only messages added in the timeframe you require.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,content,originalmessageid,project,task,date,author,contacts,public,files
Fields to return.
  • Comma separated list of any of the following:
    • author
    • contacts
    • content
    • date
    • files (returns list of any attached files)
    • originalmessageid (returns id of the message that started the discussion that this message replies to, returns blank string if this message started a new discussion)
    • project (includes id/number/title)
    • public (returns 'true' if message is public)
    • task (includes id/name)
    • title
    Example: author,title,content

OPTIONAL PARAMETERS:

contactdetails
default: false
Contact Details.
  • true - Return email, image, phone for contacts
  • false - Do not return email, image, phone for contacts

FILTER PARAMETERS:

contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Messages to/from specified Contact/s
    Example: 1,2
  • me - Messages to/from Contact making request
  • all - Messages for All Contacts
datefrom
Messages added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Messages added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
divisionid
Division ID (Advanced plan only).
  • divisionid - Messages in specified Division
    Example: 1
id
List of Message IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Messages with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Messages with ID greater than or equal to this value .
  • id - ID
    Example: 1
originalmessageid
Original Message ID.
  • originalmessageid - Messages in the discussion started by originalmessageid
    Example: 1
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Messages for specified Project/s
    Example: 1,2
projectstatus
default: active
Project Status.
  • active - Messages for Active Projects
  • complete - Messages for Completed Projects
  • all - Messages for All Projects
search
Search string.
  • string - Messages where Title contains string
    Example: website
  • !string - Messages where Title does not contain string
    Example: !layout
taskid
Task ID or List of Task IDs.
  • taskid/s - Task ID or List of Task IDs - Messages for specified Task/s
    Example: 1,2
taskstatus
default: all
Task Status.
  • active - Messages for Active Tasks
  • complete - Messages for Completed Tasks
  • all - Messages for All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Messages.
Example: pagenumber=2&pagesize=10 (return Messages 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - Message ID
  • originalmessageid - Original Message ID
  • date - Message Date
  • projectid - Project ID
  • taskid - Task ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Message

This call adds a single message. A new discussion can be started by using the projectid or taskid parameter, a reply can be added by using the originalmessageid parameter. To attach files, they must first be uploaded and can then be attached to a message using the fileid parameter.
Show Sample POST data

{
   "contacts":"1,2",
   "projectid":1,
   "title":"New Message",
   "content":"Message Content",
   "fileid":"15"
}

REQUIRED PARAMETERS:

contacts
Contacts (required when starting a new discussion).
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Contacts Assigned to Project or Task
content
Content.
  • content - Content
    Example: Sample content
originalmessageid
Message ID (Specify to reply to an existing Discussion).
  • originalmessageid - Message ID
    Example: 1
projectid
Project ID (Specify to start a new Project Discussion).
  • projectid - Project ID
    Example: 1
taskid
Task ID (Specify to start a new Task Discussion).
  • taskid - Task ID
    Example: 1
title
Title (Required when starting a new discussion).
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

files
Files to attach to the Message (Files must belong to the same Project as the Message).
  • fileid/s - File ID or List of File IDs
    Example: 1,2
notifications
default: true
Notifications (Available when starting a new discussion).
  • true - Enable Email Notifications
  • false - Disable Email Notifications
public
default: true
Public Discussion.
  • true - Make Discussion Public
  • false - Make Discussion Private

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Message

This call deletes a single Message or Discussion, this is only available for messages added by the user making the request.
NOTE: Deleting the first message in a discussion will also delete all replies in that discussion.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Message

This call returns details of a single Message.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

projectcontacts
default: false
Return project contacts.
  • true - Return project contacts
  • false - Do not return project contacts

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Message

This call updates settings for a single Message, this is only available for messages added by the user making the request and that started a new discussion.
NOTE: The title or content of a message cannot be changed.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

contacts
Contacts
NOTE: You cannot remove contacts who have added a reply to the discussion.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Contacts Assigned to Project or Task
notifications
Notifications
  • true - Enable Email Notifications
  • false - Disable Email Notifications
public
Public Discussion.
  • true - Make Discussion Public
  • false - Make Discussion Private

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

DELETE PUT POST GET

Staff
Client
Contractor
View Notes

This call returns a list of Notes. The fields parameter allows you to choose which data fields to return for each Note.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,content,category
Fields to return.
  • Comma separated list of any of the following:
    • content
    • category
    • contacts
    • date
    • lastmodified
    • title
    Example: title,content

OPTIONAL PARAMETERS:

contactdetails
default: false
Contact Details.
  • true - Return email, image, phone for contacts
  • false - Do not return email, image, phone for contacts

FILTER PARAMETERS:

categoryid
Category ID or List of Category IDs.
  • categoryid/s - Category ID or List of Category IDs - Notes for specified Category/ies
    Example: 1,2
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Notes for specified Contact/s
    Example: 1,2
  • me - Notes for Contact making request
  • all - Notes for All Contacts
datefrom
Notes added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Notes added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
divisionid
Division ID.
  • divisionid - Notes for specified Division
    Example: 1
id
List of Note IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Notes with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Notes with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Notes added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Notes added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Notes added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Notes added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
search
Search string.
  • string - Notes where Title contains string
    Example: website
  • !string - Notes where Title does not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Notes.
Example: pagenumber=2&pagesize=10 (return Notes 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: date
Sort field.
  • id - Note ID
  • title - Note Title
  • date - Note Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Note

This call adds a Note.
Show Sample POST data

{
   "title":"New Note",
   "content":"Note Description",
   "categoryid":1,
   "contacts":"1,2,3"
}

REQUIRED PARAMETERS:

categoryid
Category ID.
  • categoryid - Category ID
    Example: 1
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Assign Note to specified Contact/s
    Example: 1,2
  • me - Assign Note to Contact making request
  • all - Assign Note to All Contacts
content
Content.
  • content - Content
    Example: Sample content
title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Note

This call deletes a single Note.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Note

This call returns a single Note.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Note

This call updates a Note.
Show Sample PUT data

{
   "title":"New Note",
   "content":"Note Description"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

categoryid
Category ID.
  • categoryid - Category ID
    Example: 1
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Assign Note to specified Contact/s
    Example: 1,2
  • me - Assign Note to Contact making request
  • all - Assign Note to All Contacts
content
Content.
  • content - Content
    Example: Sample content
title
Title.
  • title - Title
    Example: Sample title

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Project Requests

This call returns a list of Project Requests based on the filters specified. The fields parameter allows you to choose which data fields to return for each Request.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,company,client,recipient,dates
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • budget
    • client
    • company
    • customfields (Advanced plan only)
    • customform (Advanced plan only)
    • dates (returns start/due/submitted)
    • description
    • duedate
    • files
    • lastmodified
    • recipient (Advanced plan only)
    • startdate
    • submitteddate
    • template (Advanced plan only)
    • title
    Example: title,company,description

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s.
  • apifieldid,string - An API Field ID and String separated by a comma (Example: 2,Europe) - Requests where the field contains the specified string
  • Multiple API Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Requests where ANY of the specified apifields match
  • all - Requests where ALL of the specified apifields match
budget
Requests where Budget matches criteria.
  • number - Budget is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Budget is GREATER THAN OR EQUAL to specified value
    Example: gte3000
  • ltenumber - Budget is LESS THAN OR EQUAL to specified value
    Example: lte3000
clientid
default: all
Client ID.
  • contactid/s - Contact ID or List of Contact IDs - Requests made by any of the specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Requests NOT made by any of the specified Contact/s
    Example: !1,2
  • me - Requests made by Contact making request
  • all - All Requests
clienttype
default: all
Client Type (Advanced plan only).
  • external - External Project Requests
  • internal - Internal Project Requests
  • all - All Project Requests
companyid
Company ID.
  • companyid/s - Requests in specified Company/ies
    Example: 1,2,3
  • !companyid/s - Requests NOT for specified Company/ies
    Example: !1,2
customfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
customfieldsmode
default: any
Mode used for the customfields parameter.
  • any - Requests where ANY of the specified customfields match
  • all - Requests where ALL of the specified customfields match
divisionid
Division ID (Advanced plan only).
  • divisionid - Requests in specified Division
    Example: 1
duedatefrom
Requests with due date on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Requests with due date on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
idfrom
Requests with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Requests with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Requests added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Requests added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Requests added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Requests added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
recipientid
default: all
Recipient ID (Advanced plan only).
  • recipientid/s - Contact ID or List of Contact IDs - Requests submitted to any of the specified Contact/s
  • !recipientid/s - Contact ID or List of Contact IDs - Requests NOT submitted to any of the specified Contact/s
  • me - Requests submitted to Contact making request
  • all - All Requests
searchcustomform
Search Custom Form (Advanced plan only).
  • string - Requests where Custom Form contains string
    Example: website
  • !string - Requests where Custom Form does not contain string
    Example: !layout
searchdescription
Search Description.
  • string - Requests where Description contains string
    Example: website
  • !string - Requests where Description does not contain string
    Example: !layout
searchtitle
Search Title.
  • string - Requests where Title contains string
    Example: website
  • !string - Requests where Title does not contain string
    Example: !layout
startdatefrom
Requests with start date on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Requests with start date on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
submitteddatefrom
Requests submitted on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
submitteddateto
Requests submitted on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
templateid
Project Template ID (Advanced plan only).
  • templateid/s - Requests using specified Template IDs
    Example: 1,2,3
  • !templateid/s - Requests NOT using specified Template IDs
    Example: !1,2

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Requests.
Example: pagenumber=2&pagesize=10 (return Requests 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - ID
  • title - Title
  • startdate - Start Date
  • duedate - Due Date
  • submitteddate - Submitted Date
  • companyid - Company ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Project Request

This call adds a Project Request. Files can be added subsequently using the Add Files call with projectid set to the ID of the Project Request. In the Advanced Plan you may specify templateid to use a Project Template (any values you provide will override those in the Project Template). In the Advanced Plan you may specify contactid or divisionid (if neither is provided then the request will be submitted to the default contact for the same division as the user making the request). In the Advanced Plan you must specify groupid if the contactid you are submitting to belongs to more than 1 group.
Show Sample POST data

{
   "title":"Sample Request",
   "description":"Sample Request Description",
   "contactid":1,
   "startdate":"2014-04-18",
   "duedate":"2014-04-28",
   "customfields":
   [
      {
         "id":1,
         "value":"Europe"
      },
      {
         "id":2,
         "value":"Industrial"
      }
   ]
}

REQUIRED PARAMETERS:

title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
    { "id":1, "value":"Europe"},
    { "id":2, "value":"Industrial"}
    ]
budget
Budget.
  • budget - Budget
    Example: 5000.00
contactid
Contact ID (Advanced plan only).
  • contactid - Contact ID
    Example: 1
customfields
Custom Field Value/s (Advanced plan only)
  • customfields - Custom Fields
    You must specify id and value (use the settings/projects/customfields call for a list of ids and values).
    Example:
    "customfields":
    [
    { "id":1, "value":"Europe"},
    { "id":2, "value":"Industrial"}
    ]
customformcontent
Custom Form Content (Advanced plan only).
  • customformcontent - Custom Form Content
    Example: Sample Form Content
customformtitle
Custom Form Title (Advanced plan only).
  • customformtitle - Custom Form Title
    Example: Sample Form Title
description
Description.
  • description - Description
    Example: Sample Description
divisionid
Division ID (Advanced plan only).
  • divisionid - Division ID
    Example: 1
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
groupid
Group ID (Advanced Plan only, required if contactid belongs to more than 1 Group).
  • groupid - Group ID
    Example: 1
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
submitterid
Submitter ID - use this if you want to submit a request on behalf of another user, the user must be a client contact.
  • contactid - Submitter ID ID
    Example: 1
templateid
Template ID (Advanced plan only).
  • templateid - Project Template ID
    Example: 1

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Project Request

This call deletes a single Project Request, only the contact who submitted a Request is allowed to delete it. This call is NOT used to decline a Request, use the decline call instead.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project Request

This call returns details of a single Project Request.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Project Request

This call updatesa single Project Request, only the contact who submitted a Request is allowed to edit it.
IMPORTANT - This call is NOT used to approve or decline a Request, use the specific approve and decline calls instead.
Show Sample PUT data

{
   "title":"Sample Request",
   "description":"Sample Request Description",
   "startdate":"2014-04-18",
   "duedate":"2014-04-28",
   "customfields":
   [
      {
         "id":1,
         "value":"Europe"
      },
      {
         "id":2,
         "value":"Industrial"
      }
   ]
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
    { "id":1, "value":"Europe"},
    { "id":2, "value":"Industrial"}
    ]
budget
Budget.
  • budget - Budget
    Example: 5000.00
customfields
Custom Field Value/s (Advanced plan only)
  • customfields - Custom Fields
    You must specify id and value (use the 'settings/projects/customfields' call for a list of ids and values).
    Example:
    "customfields":
    [
    { "id":1, "value":"Europe"},
    { "id":2, "value":"Industrial"}
    ]
customformcontent
Custom Form Content (Advanced plan only).
  • customformcontent - Custom Form Content
    Example: Sample Form Content
customformtitle
Custom Form Title (Advanced plan only).
  • customformtitle - Custom Form Title
    Example: Sample Form Title
description
Description.
  • description - Description
    Example: Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
title
Title.
  • title - Title
    Example: Sample title

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Approve a Project Request

This call approves a single Project Request. In the Solo and Professional plan, the contact approving the new Project is assigned as the Project Manager; in the Advanced plan the new Project is assigned to the contact the Request was submitted to.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

autonumberid
Autonumbering Option ID (Advanced Plan only, required if Advanced autonumbering is enabled and the Team the Request was submitted to has more than one Autonumber option. The 'settings/projects/autonumbering' call returns a list of available IDs.).
  • autonumberid - Autonumbering Option ID
    Example: 1
clientaccess
Client Access (true/false to set whether Client can View this Project).
  • true - Client can View Project
  • false - Client cannot View Project
emailalerts
Email Alerts (true/false to set whether Email Alerts are sent for activity in this Project).
  • true - Send Email Alerts
  • false - Don't Send Email Alerts
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Decline a Project Request

This call declines a single Project Request.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

DELETE PUT POST GET

Staff
Client
Contractor
View Projects

This call returns a list of Projects based on the filters specified. The fields parameter allows you to choose which data fields to return for each Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,number,company,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • accountedfor (Accounted For Status - true/false)
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • burn (returns budget/burn/totalburn where burn reflects the burn based on any time-based filters)
    • category
    • company (for internal Projects in the Advanced plan, this will also return internalclientteamid, internalclientteamname, internalclientgroupid and internalclientgroupname)
    • completedate
    • contacts (returns clients/contractors/manager/staff)
    • customfields (Advanced plan only)
    • customform (Advanced plan only)
    • customstatus (Advanced plan only)
    • dates (returns start/due/complete)
    • description
    • duedate
    • expensestotal
    • group (Advanced plan only)
    • invoiced (Invoiced Status - true/false)
    • invoicetotal
    • lastmodified
    • manager
    • number
    • paid (Paid Status - true/false)
    • percentcomplete (percentage of tasks completed, heading tasks excluded)
    • priority
    • privatenotes (staff only)
    • purchaseordernumber
    • quotetotal
    • startdate
    • status
    • tags
    • tasklists
    • team (Advanced plan only)
    • timeallocated
    • timetracked
    • title
    • type
    • (Advanced plan only, returns 'internal' or 'external')
    Example: number,title,company

OPTIONAL PARAMETERS:

timetrackedcomparisonoption
default: project
Time Tracked Comparison Option - specify the total to compare against when using a date option in the 'timetracked' option.
  • project - Compare against Project Allocated Time
  • tasks - Compare against total of Task Allocated Time

FILTER PARAMETERS:

accountedfor
default: all
Accounted For Status.
  • accountedfor - Projects marked as Accounted For
  • unaccountedfor - Projects marked as Unaccounted For
  • all - All Projects
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Projects where the field contains the specified string.
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Projects where ANY of the specified apifields match
  • all - Projects where ALL of the specified apifields match
categoryid
Category ID or List of Category IDs.
  • categoryid/s - Projects in specified Category/ies
    Example: 1,2,3
  • !categoryid/s - Projects NOT in specified Category/ies
    Example: !1,2,3
companyid
Company ID or List of Company IDs.
  • companyid/s - Projects in specified Company/ies
    Example: 1,2,3
  • !companyid/s - Projects NOT for specified Company/ies
completedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Projects assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Projects NOT assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: !1,2
  • me - Projects assigned to Contact making request
  • all - All Projects
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Projects assigned to ANY of the specified contacts
  • all - Projects assigned to ALL of the specified contacts
customfieldoptionid
Custom Field Option ID/s (Advanced plan only)
  • customfieldoptionid/s - Projects with specified Custom Field Option/s (applies only to custom fields of dropdown type)
    Example: 1,2
customfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
customfieldsmode
default: any
Mode used for the customfields or customfieldoptionid parameter.
  • any - Projects where ANY of the specified customfields match
  • all - Projects where ALL of the specified customfields match
  • none - Projects where NONE of the specified customfields match
customstatusid
Custom Status ID or List of Custom Status IDs (Advanced plan only).
  • customstatusid/s - Projects with specified Custom Status/es
    Example: 1,2
  • !customstatusid/s - Projects without specified Custom Status/es
    Example: !1,2
divisionid
Division ID (Advanced plan only).
  • divisionid - Projects in specified Division
    Example: 1
duedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
groupid
Group (Advanced plan only).
  • groupid/s - Group ID or List of Group IDs - Projects Managed by any of the specified Group/s
    Example: 1,2
  • !groupid/s - Group ID or List of Group IDs - Projects NOT Managed by any of the specified Group/s
    Example: !1,2
id
List of Project IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Projects with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Projects with ID greater than or equal to this value .
  • id - ID
    Example: 1
internalclientgroupid
Group ID or List of Group IDs.
  • groupid/s - Projects for specified Group/s
    Example: 1,2,3
internalclientteamid
Team ID or List of Team IDs.
  • teamid/s - Projects for specified Team/s
    Example: 1,2,3
invoiced
default: all
Invoiced Status.
  • invoiced - Projects marked as Invoiced
  • uninvoiced - Projects marked as Uninvoiced
  • all - All Projects
invoicetotal
Projects where Invoice Total matches criteria.
  • number - Invoice Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Invoice Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Invoice Total is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Invoice Total is GREATER THAN Quote Total (Projects with 0 Quote Total ignored)
  • under - Invoice Total is LESS THAN OR EQUAL TO Quote Total (Projects with 0 Quote Total ignored)
  • gtenumber% - Invoice Total is GREATER THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: gte30%
  • ltenumber% - Invoice Total is LESS THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: lte30%
lastmodifiedfrom
Projects added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Projects added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Projects added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Projects added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
default: all
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Projects Managed by any of the specified Contact/s
    Example: 1,2
  • !managerid/s - Contact ID or List of Contact IDs - Projects NOT Managed by any of the specified Contact/s
    Example: !1,2
  • me - Projects Managed by Contact making request
  • all - All Projects
paid
default: all
Paid Status.
  • paid - Projects marked as Paid
  • unpaid - Projects marked as Unpaid
  • all - All Projects
priority
Priority or List of Priorities (1-5 representing Very High-Very Low).
  • priority/ies - Projects with specified Priority/ies
    Example: 1,2
  • !priority/ies - Projects NOT with specified Priority/ies
    Example: !4,5
quotetotal
Projects where Quote Total matches criteria.
  • number - Quote Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Quote Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Quote Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
search
Search.
  • string - Projects where Number or Title contains string
    Example: website
  • !string - Projects where Number and Title do not contain string
    Example: !layout
searchcustomform
Search Custom Form (Advanced plan only).
  • string - Projects where Custom Form contains string
    Example: website
  • !string - Projects where Custom Form does not contain string
    Example: !layout
searchdescription
Search Description.
  • string - Projects where Description contains string
    Example: website
  • !string - Projects where Description does not contain string
    Example: !layout
searchnumber
Search Name.
  • string - Projects where Number contains string
    Example: website
  • !string - Projects where Number does not contain string
    Example: !layout
searchtitle
Search Title.
  • string - Projects where Title contains string
    Example: website
  • !string - Projects where Title does not contain string
    Example: !layout
startdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Status.
  • active - Active Projects
  • complete - Completed Projects
  • all - All Projects
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Projects with specified Tag/s
    Example: 1,2,3
  • !tagid/s - Projects without specified Tag/s
    Example: !1,2,3
teamid
Team (Advanced plan only).
  • teamid/s - Team ID or List of Team IDs - Projects Managed by any of the specified Team/s
    Example: 1,2
  • !teamid/s - Team ID or List of Team IDs - Projects NOT Managed by any of the specified Team/s
    Example: !1,2
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timebillable
default: all
Billable/Non-billable/All Time Tracked.
  • all - All Time
  • billable - Billable Time only
  • nonbillable - Non-billable Time only
timetracked
Projects where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto and timebillable parameters will apply to the starred options.
IMPORTANT: The non-starred options will always use the Total Time Tracked (all contacts, dates, billable status) for comparison.
Use the 'timetrackedcomparisonoption' to compare against either the Project Allocated Time or the total of Task Allocated Time.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
upcomingdatefrom
Projects with a start OR due date on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
upcomingdateto
Projects with a start OR due date on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Projects.
Example: pagenumber=2&pagesize=10 (return Projects 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: number
Sort field.
  • id - ID
  • title - Title
  • number - Number
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • categoryname - Category Name
  • companyname - Company Name
  • priority - Priority
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Project

This call adds a Project. In the Advanced Plan you may specify templateid to use a Project Template (any values you provide will override those in the Project Template). In the Advanced Plan you may specify either companyid (for external Projects) or internalclientcontactid (for internal Projects). If the internalclientcontactid belongs to more than 1 group you must also specify internalclientgroupid. In the Advanced Plan you must also specify groupid if the managerid belongs to more than 1 group.
Show Sample POST data

{
   "title":"Sample Project",
   "number":"auto",
   "description":"Sample Project Description",
   "companyid":1,
   "managerid":"me",
   "staff":"2,3,5",
   "clients":"6,7",
   "contractors":"9,10",
   "priority":2,
   "startdate":"2014-04-18",
   "duedate":"2014-04-28",
   "customfields":
   [
      {
         "id":1,
         "value":"Europe"
      },
      {
         "id":2,
         "value":"Industrial"
      }
   ]
}

REQUIRED PARAMETERS:

companyid
Client Company ID.
  • companyid - Company ID
    Example: 1
internalclientcontactid
Internal Client Contact ID (Advanced plan only).
  • internalclientcontactid - Contact ID
    Example: 1
internalclientgroupid
Internal Client Group ID (Advanced Plan only, required if internalclientcontactid belongs to more than 1 Group).
  • internalclientgroupid - Group ID
    Example: 1
title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
autonumberid
Autonumbering Option ID (Advanced Plan only, required if Advanced autonumbering is enabled and the Team of 'managerid' has more than one Autonumber option. The 'settings/projects/autonumbering' call returns a list of available IDs.).
  • autonumberid - Autonumbering Option ID
    Example: 1
categoryid
Project Category ID.
  • categoryid - Category ID
    Example: 1
clientaccess
Client Access (true/false to set whether Client can View this Project).
  • true - Client can View Project
  • false - Client cannot View Project
clients
Assigned Clients.
  • clients - Contact ID or List of Contact IDs
    Example: 1,2,3
completedate
Complete Date, if specified then the Project will be added with a Completed status (alerts are not sent when adding Completed Projects).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contractors
Assigned Contractors.
  • contractors - Contact ID or List of Contact IDs
    Example: 1,2,3
customfields
Custom Field Value/s (Advanced plan only)
  • customfields - Custom Fields
    You must specify id and value (use the settings/projects/customfields call for a list of ids as well as options for fields of dropdown type).
    Example:
    "customfields":
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"2020-07-21"
       }
    ]
customformcontent
Custom Form Content (Advanced plan only).
  • customformcontent - Custom Form Content
    Example: Sample Form Content
customformtitle
Custom Form Title (Advanced plan only).
  • customformtitle - Custom Form Title
    Example: Sample Form Title
customstatusid
Custom Status ID (Advanced plan only).
  • customstatusid - Custom Status ID
    Example: 1
description
Description.
  • description - Description
    Example: Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
emailalerts
Email Alerts (true/false to set whether Email Alerts are sent for activity in this Project).
  • true - Send Email Alerts
  • false - Don't Send Email Alerts
groupid
Group ID (Advanced Plan only, required if managerid belongs to more than 1 Group).
  • groupid - Group ID
    Example: 1
invoicetotal
Invoiced Value.
  • invoicetotal - Invoiced Value
    Example: 1000.00
  • auto - Total of Project Invoices
managerid
default: me
Manager ID.
  • managerid - Manager Contact ID
    Example: 1
  • me - Contact making request
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering
priority
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
privatenotes
Private Notes (Visible to Staff only).
  • privatenotes - Private Notes
    Example: Sample Private Notes
purchaseordernumber
Purchase Order Number.
  • purchaseordernumber - Purchase Order Number
    Example: PO-1234
quotetotal
Quoted Value.
  • quotetotal - Quoted Value
    Example: 1000.00
  • auto - Total of Project Quotes
staff
Assigned Staff.
  • staff - Contact ID or List of Contact IDs
    Example: 1,2,3
  • me - Contact making request
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
templateid
Template ID (Advanced plan only).
  • templateid - Project Template ID
    Example: 1
timeallocated
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Project

This call deletes a single Project, this will also delete all Tasks, Files, Messages & Time Records for the Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project

This call returns details of a single Project. Detailed information about tasks, time, messages, files, quotes and invoices can be returned by setting the associated options.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

contactdetails
default: false
Contact Details.
  • true - Return email, image, phone for contacts
  • false - Do not return email, image, phone for contacts
files
default: false
Files.
  • true - Include Files
  • false - Do Not Include Files
folders
default: false
Custom Folders.
  • true - Include Custom Folders
  • false - Do Not Include Custom Folders
invoices
default: false
Invoices.
  • true - Include Invoices
  • false - Do Not Include Invoices
messages
default: false
Messages.
  • true - Include Messages
  • false - Do Not Include Messages
messagescontacts
default: me
Messages Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Include Messages to/from specified Contact/s
    Example: 1,2
  • me - Include Messages to/from Contact making request
  • all - Include Messages for All Contacts
quotes
default: false
Quotes.
  • true - Include Quotes
  • false - Do Not Include Quotes
tasks
default: false
Tasks.
  • true - Include Tasks
  • false - Do Not Include Tasks
timerecords
default: false
Time Records (Staff only).
  • true - Include Individual Time Records
  • false - Do Not Include Individual Time Records

FILTER PARAMETERS:

timebillable
default: all
Billable/Non-billable/All Time Tracked.
  • all - All Time
  • billable - Billable Time only
  • nonbillable - Non-billable Time only
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Project

This call updates a single Project. In the Advanced Plan you may specify either companyid (for external Projects) or internalclientcontactid (for internal Projects). If the internalclientcontactid belongs to more than 1 group you must also specify internalclientgroupid. In the Advanced Plan you must also specify groupid if the managerid belongs to more than 1 group. It is not possible to change an External Project to an Internal Project (or vice-versa) via the API.
IMPORTANT - This call is NOT used to complete or reactivate a Project, use the specific complete and reactivate calls instead.
Show Sample PUT data

{
   "title":"Sample Project",
   "description":"Sample Project Description",
   "priority":2,
   "startdate":"2014-04-18",
   "duedate":"2014-04-28",
   "customfields":
   [
      {
         "id":1,
         "value":"Europe"
      },
      {
         "id":2,
         "value":"Industrial"
      }
   ]
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

accountedfor
Accounted For Status (true/false to set whether Project is accounted for).
  • true - Set Project as Accounted For
  • false - Set Project as Accounted For
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
categoryid
Project Category ID.
  • categoryid - Category ID
    Example: 1
clients
Assigned Clients.
  • clients - Contact ID or List of Contact IDs
    Example: 1,2,3
companyid
Client Company ID.
  • companyid - Company ID
    Example: 1
completedate
Complete Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contractors
Assigned Contractors.
  • contractors - Contact ID or List of Contact IDs
    Example: 1,2,3
customfields
Custom Field Value/s (Advanced plan only)
  • customfields - Custom Fields
    You must specify id and value (use the settings/projects/customfields call for a list of ids and values).
    Example:
    "customfields":
    [
    { "id":1, "value":"Europe"},
    { "id":2, "value":"Industrial"}
    ]
customformcontent
Custom Form Content (Advanced plan only).
  • customformcontent - Custom Form Content
    Example: Sample Form Content
customformtitle
Custom Form Title (Advanced plan only).
  • customformtitle - Custom Form Title
    Example: Sample Form Title
customstatusid
Custom Status ID (Advanced plan only).
  • customstatusid - Custom Status ID
    Example: 1
description
Description.
  • description - Description
    Example: Sample Description
  • +=description - Append to Existing Description
    Example: +=Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
groupid
Group ID (Advanced Plan only, required if managerid belongs to more than 1 Group).
  • groupid - Group ID
    Example: 1
internalclientcontactid
Internal Client Contact ID (Advanced plan only).
  • internalclientcontactid - Contact ID
    Example: 1
internalclientgroupid
Internal Client Group ID (Advanced Plan only, required if internalclientcontactid belongs to more than 1 Group).
  • internalclientgroupid - Group ID
    Example: 1
invoiced
Invoiced Status (true/false to set whether Project is invoiced).
  • true - Set Project as Invoiced
  • false - Set Project as not Invoiced
invoicetotal
Invoiced Value.
  • invoicetotal - Invoiced Value
    Example: 1000.00
  • auto - Total of Project Invoices
managerid
Manager ID.
  • managerid - Manager Contact ID
    Example: 1
  • me - Contact making request
number
Number.
  • number - Number
    Example: ABC-00001
paid
Paid Status (true/false to set whether Project is paid).
  • true - Set Project as paid
  • false - Set Project as not paid
priority
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
privatenotes
Private Notes (Visible to Staff only).
  • privatenotes - Private Notes
    Example: Sample Private Notes
  • +=privatenotes - Append to Existing Private Notes
    Example: +=Sample Private Notes
purchaseordernumber
Purchase Order Number.
  • purchaseordernumber - Purchase Order Number
    Example: PO-1234
quotetotal
Quoted Value.
  • quotetotal - Quoted Value
    Example: 1000.00
  • auto - Total of Project Quotes
staff
Assigned Staff.
  • staff - Contact ID or List of Contact IDs
    Example: 1,2,3
  • me - Contact making request
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
timeallocated
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300
title
Title.
  • title - Title
    Example: Sample title

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Check Project Access

Check whether a contact can view the Project.

REQUIRED PARAMETERS:

contactid
default: me
Contact.
  • contactid - Check Access for Contact ID (only Staff can check Access for another Contact)
    Example: 1
  • me - Check Access for Contact making request

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Adjust date/s for a Project and/or its Tasks

This call adjusts the dates for a single Project and/or its Tasks, by default this will adjust the start AND due dates of the Project, you can use the 'dates' option to adjust just the start or due date or omit it to adjust neither (if you only want to adjust Tasks). If you want to adjust the dates of Tasks in the Project then set the 'tasks' and 'taskdates' options accordingly. Set the 'adjustment' option to set the number of calendar days/weeks/months/years to adjust the Project/Tasks by.
IMPORTANT: A positive value defers a Project/Tasks, a negative value advances a Project/Tasks.
Use this call with care as running it multiple times by mistake will adjust dates multiple times.
Show Sample PUT data

{
   "adjustment":"+1w",
   "dates":"all",
   "tasks":"active",
   "taskdates":"due"
}

REQUIRED PARAMETERS:

adjustment
Adjustment.
  • +/-Xd/w/m/y - +/-Xd/w/m/y (Example: -3w - advance dates by 3 weeks, +1m - defer dates by 1 month)

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

dates
Project Dates to update.
  • all - Start and Due Date
  • due - Due Date
  • start - Start Date
taskdates
Task Dates to update.
  • all - Start and Due Date
  • due - Due Date
  • start - Start Date
tasks
Tasks to adjust.
  • all - All Tasks
  • active - Active Tasks
  • complete - Completed Tasks

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Bookmarks for a Project

This call returns details of the Bookmarks for a Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Bookmark to a Project

This call adds a single Bookmark.
Show Sample POST data

{
   "title":"New Bookmark",
   "link":"http://www.proworkflow.com"
}

REQUIRED PARAMETERS:

link
URL Link.
  • link - Link URL
    Example: http://www.proworkflow.com
title
Title.
  • title - Title
    Example: Sample Title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Project Bookmark

This call deletes a single Project Bookmark.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project Bookmark

This call returns details of a single Project Bookmark.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Project Bookmark

This call updates a single Project Bookmark.
Show Sample PUT data

{
   "title":"Sample Title"
   "link":"http://www.proworkflow.com"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

link
URL Link.
  • link - Link
    Example: http://www.proworkflow.com
title
Title.
  • title - Title
    Example: Sample Title

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Complete a Project

This call completes a single Project, this will also complete any active Tasks in the Project. You can specify 'completedate' otherwise the current user's time is used.
Show Sample PUT data

{
   "completedate":"2014-04-28"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

completedate
Complete Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View contacts assigned to a Project

This call returns details of the Contacts assigned to a Project (including Manager).

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add/Remove Contacts to a Project

This call adds or removes Contacts to/from a single Project (use the 'remove' option to REMOVE Contacts, default is to ADD Contacts. When adding contacts you can use the 'assigntotasks' option to assign the added Contacts to ALL Tasks in the Project. This call cannot be used to change the Project Manager, use the 'projects/projectid' call instead.
IMPORTANT - This call is NOT used to complete or reactivate a Project, use the specific complete and reactivate calls instead.
Show Sample PUT data

{
   "staff":"1,2",
   "assigntotasks":true
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

assigntotasks
default: false
Assign added Contacts to All Tasks.
  • true - Assign added Contacts to All Tasks
  • false - Don't Assign added Contacts to All Tasks
clients
Clients to Add/Remove.
  • clients - Contact ID or List of Contact IDs
    Example: 1,2,3
contractors
Contractors to Add/Remove.
  • contractors - Contact ID or List of Contact IDs
    Example: 1,2,3
remove
default: false
Set as 'true' to remove Contacts (default is to add them).
  • true - Remove Contacts from Project
  • false - Add Contacts to Project
staff
Staff to Add/Remove.
  • staff - Contact ID or List of Contact IDs
    Example: 1,2,3
  • me - Contact making request

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Expenses for a Project

This call returns details of the Expenses for a Project based on the specified filters. The fields parameter allows you to choose which data fields to return for each Expense.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,description,cost,date
Fields to return.
  • Comma separated list of any of the following:
    • company
    • contact
    • cost
    • date
    • invoiced
    • name
    • project(includes id/number/title)
    • taxable
    Example: name,cost,date

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Expenses for specified Contact/s
    Example: 1,2
  • me - Expenses for Contact making request
  • all - Expenses for All Contacts
datefrom
Expenses added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Expenses added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
invoiced
default: all
Invoiced status.
  • invoiced - Invoiced Expenses
  • uninvoiced - Uninvoiced Expenses
  • all - All Expenses
search
Search string.
  • string - Expenses where Name contains string
    Example: website
  • !string - Expenses where Name does not contain string
    Example: !layout
taxable
default: all
Taxable status.
  • taxable - Taxable Expenses
  • nontaxable - Non-Taxable Expenses
  • all - All Expenses

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Expenses.
Example: pagenumber=2&pagesize=10 (return Expenses 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: date
Sort field.
  • id - Expense ID
  • name - Expense Name
  • date - Expense Date
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add an Expense

This call adds a single Expense to a Project.
Show Sample POST data

{
   "name":"New Expense",
   "description":"Event Description",
   "date":"2014-03-28",
   "cost":100.00
}

REQUIRED PARAMETERS:

cost
Cost of Expense.
  • cost - Cost
    Example: 500.00
name
Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

date
Date of Expense.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
description
Description.
  • description - Description
    Example: Sample Description
invoiced
default: false
Invoiced status.
  • true - Invoiced
  • false - Uninvoiced
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Files for a Project

This call returns details of Files for a Project based on the specified filters. The fields parameter allows you to choose which data fields to return for each File.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,task,date,size,link
Fields to return.
  • Comma separated list of any of the following:
    • contacts (returns 'all' if File is public, returns array of contacts if File is private)
    • date
    • folder (includes id,name)
    • link
    • name
    • project (includes id/number/title)
    • size
    • task (includes id/name)
    Example: name,size,link

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

datefrom
Files added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Files added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
search
Search string.
  • string - Files where Name contains string
    Example: website
  • !string - Files where Name does not contain string
    Example: !layout
taskstatus
default: all
Task Status.
  • active - Files for Active Tasks
  • complete - Files for Completed Tasks
  • all - Files for All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Files.
Example: pagenumber=2&pagesize=10 (return Files 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - File ID
  • name - File Name
  • size - File Size
  • date - File Date
  • taskid - Task ID
  • folderid - Folder ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a File to a Project

This call adds a single File to a Project. To add a File to a Custom Folder, use the '/files' call with the 'folderid' option.
Show Sample POST data

{
   "name":"filename.txt",
   "content":"U29tZSB0ZXh0"
}

REQUIRED PARAMETERS:

content
Base64-encoded content.
  • content
name
Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Invoices for a Project

This call returns a list of Invoices for a Project based on the filters specified and optionally subtotals based on the grouping options specified, it also returns the totals of all the returned quotes. The subtotals parameter allows you to return Sub Totals of invoiced amounts. The fields parameter allows you to return individual Invoices and choose which data fields to return for each Invoice. This call does not return details of the individual lines for each Invoice, you can use the specific Invoice call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: number,title,status,dates,totals
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • company
    • dates (invoiced/due/paid)
    • duedate
    • emaileddate
    • emailedto
    • grandtotal
    • invoicedby
    • invoiceddate
    • lastmodified
    • number
    • paiddate
    • project (project id/title/number)
    • purchaseordernumber
    • status
    • subtotal
    • taxable
    • taxtotal
    • title
    • totals (sub/tax/grand totals)
    • xero (Staff only, requires Xero integration)
    Example: number,title,totals
  • none - return only Totals/Subtotals
subtotals
Sub Totals - specify required subtotals, if not specified then only Fields/Totals will be returned.
  • Comma separated list of any of the following in the required order:
    • company
    • project
    • status

    • day
    • week
    • month
    • year
    Use the 'subtotalsdateoption' to specify whether to group by invoiced, due or paid date (if week is used then the 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' date will be used as the first day of the week).
    Example: company,month - return Sub Totals of Invoiced amounts for each combination of Company and Month.
    NOTE - Only non-zero Sub Totals will be returned.
    IMPORTANT - To use date grouping options you must specify 'invoiceddatefrom' or 'duedatefrom' or 'paiddatefrom' depending on the option user for 'subtotalsdateoption'.

OPTIONAL PARAMETERS:

subtotalsdateoption
default: invoiced
Sub Totals Date Option - specify the date to group by when using a date option in the 'subtotals' option.
  • invoiced - Group by Invoiced Date
  • due - Group by Due Date
  • paid - Group by Paid Date

FILTER PARAMETERS:

apifields
API Field Value/s.
  • apifieldid,string - An API Field ID and String separated by a comma - Invoices where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Invoices where ANY of the specified apifields match
  • all - Invoices where ALL of the specified apifields match
duedatefrom
Invoices due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Invoices due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
grandtotal
Invoice grandtotal.
  • number - Invoice Invoice Grand Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Grand Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Grand Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
invoiceddatefrom
Invoices created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
invoiceddateto
Invoices created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
paiddatefrom
Invoices paid on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
paiddateto
Invoices paid on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
searchnumber
Search string.
  • string - Invoices where Number contains string
    Example: website
  • !string - Invoices where Number does not contain string
    Example: !layout
searchtitle
Search string.
  • string - Invoices where Title contains string
    Example: website
  • !string - Invoices where Title does not contain string
    Example: !layout
status
default: all
Invoice Status.
  • paid - Paid Invoices
  • unpaid - Unpaid Invoices
  • all - All Invoices
subtotal
Invoice Sub Total.
  • number - Invoice Sub Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Sub Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Sub Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
taxable
default: all
Taxable status.
  • true - Taxable Invoices
  • false - Non-Taxable Invoices
  • all - All Invoices
taxtotal
Invoice Tax Total.
  • number - Invoice Invoice Tax Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Invoice Tax Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Invoice Tax Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Invoices.
Example: pagenumber=2&pagesize=10 (return Invoices 11-20). (Paging options are not available if you are using the 'subtotals' option)
  • pagenumber
pagesize
Page Size (must be used with pagenumber). (Paging options are not available if you are using the 'subtotals' option)
  • pagesize
sortby
default: number
Sort field.
  • id - Invoice ID
  • number - Invoice Title
  • title - Invoice Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add an Invoice

This call adds a simple Invoice to a Project. You must specify ONE of lineitems or taskrates or staffrates.
Show Sample POST data

{
   "title":"New Invoice",
   "number":"auto",
   "description":"Invoice Description",
   "contactid":1,
   "lines":
   [
      {
         "type":"heading",
         "name":"Redesign Work"
      },
      {
         "type":"lineitem",
         "name":"Line Item 1",
         "quantity":1,
         "rate":100.00,
         "taxable":true
      },
      {
         "type":"taskrate",
         "name":"Task Rate",
         "time":60,
         "rate":100.00,
         "taxable":false
      },
      {
         "type":"staffrate",
         "name":"Alex Trip",
         "time":60,
         "rate":100.00,
         "taxable":false
      }
   ]
}

REQUIRED PARAMETERS:

companyid
Client Company ID.
  • companyid - Company ID
    Example: 1
contactid
Client Contact ID.
  • contactid - Contact ID
    Example: 1
lines
Line/s.
  • lines - Line/s

    The 'type' must be specified, the following must then be specified depending on the 'type':
    • 'heading' - Must provide 'name'
    • 'expense' - Must provide 'name' as well as 'quantity' & 'rate'
    • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
    • 'staffrate' - Must provide 'name', 'time' & 'rate'
    • 'taskrate' - Must provide 'name', 'time' & 'rate'
    Example:
    [
       {
          "type":"heading",
          "name":"Redesign Work"
       },
       {
          "type":"lineitem",
          "name":"Line Item 1",
          "name":"Line Item 1 Description",
          "quantity":1,
          "rate":100.00,
          "taxable":true
       },
       {
          "type":"taskrate",
          "name":"Task Rate",
          "time":60,
          "rate":100.00,
          "taxable":false
       },
       {
          "type":"staffrate",
          "name":"Alex Trip",
          "time":60,
          "rate":100.00,
          "taxable":false
       }
    ]
title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
companyname
Address Company Name.
  • companyname - Address Line 2
    Example: ABC Ltd
contactname
Address Contact Name.
  • contactname - Address Line 1
    Example: Amy Adams
country
Country.
  • country - Country
    Example: Someland
description
Description.
  • description - Description
    Example: Sample Description
discountdescription
default: Discount
Discount Description.
  • discountdescription - Discount Description
    Example: Sample Discount
discountvalue
Discount Value.
  • number - Apply a Fixed Value Discount
    Example: 500
  • number% - Apply a percentage Discount
    Example: 10%
duedate
Due Date (if not specified then this will be calculated automatically from Invoiced Date and default payment settings).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
invoiceddate
Invoiced Date (defaults to current date)
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
markprojectasinvoiced
default: false
Mark Project as Invoiced.
  • true - Project will be set as invoiced
  • false - Project will not be updated
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering
showcostbreakdown
default: true
Show Cost Breakdown (in main application).
  • true - Show Cost Breakdown
  • false - Hide Cost Breakdown
state
State.
  • state - State
    Example: Somewhere
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable
taxrate
Tax rate (overrides default rate).
  • number - Tax Rate (%)
    Example: 12.5
terms
Terms.
  • terms - Terms
    Example: Valid for 14 Days
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Messages for a Project

This call returns details of Messages for a Project. The fields parameter allows you to choose which data fields to return for each Message.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,content,originalmessageid,taskid,date,author,contacts,public,files
Fields to return.
  • Comma separated list of any of the following:
    • author
    • contacts
    • content
    • date
    • files (returns list of any attached files)
    • originalmessageid (returns id of the message that started the discussion that this message replies to, returns blank string if this message started a new discussion)
    • project (includes id/number/title)
    • projectid
    • projectnumber
    • projecttitle
    • public (returns 'true' if message is public)
    • task (includes id/name)
    • taskid
    • taskname
    • title
    Example: author,title,content

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Messages to/from specified Contact/s
    Example: 1,2
  • me - Messages to/from Contact making request
  • all - Messages for All Contacts
datefrom
Messages added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Messages added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
divisionid
Division ID (Advanced plan only).
  • divisionid - Messages in specified Division
    Example: 1
originalmessageid
Original Message ID.
  • originalmessageid - Messages in the discussion started by originalmessageid
    Example: 1
search
Search string.
  • string - Messages where Title contains string
    Example: website
  • !string - Messages where Title does not contain string
    Example: !layout
taskid
Task ID or List of Task IDs.
  • taskid/s - Task ID or List of Task IDs - Messages for specified Task/s
    Example: 1,2
taskstatus
default: all
Task Status.
  • active - Messages for Active Tasks
  • complete - Messages for Completed Tasks
  • all - Messages for All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Messages.
Example: pagenumber=2&pagesize=10 (return Messages 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - Message ID
  • originalmessageid - Original Message ID
  • date - Message Date
  • projectid - Project ID
  • taskid - Task ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Message to a Project

This call starts a new discussion in a Project. To attach files, they must first be uploaded and can then be attached to a message using the fileid parameter. To reply to an existing discussion, use the '/messsages' call with the 'originalmessageid' option.
Show Sample POST data

{
   "contacts":"1,2",
   "title":"New Message",
   "content":"Message Content",
   "fileid":"15"
}

REQUIRED PARAMETERS:

contacts
Contacts (required when starting a new discussion).
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Contacts Assigned to Project
content
Content.
  • content - Content
    Example: Sample content
title
Title (Required when starting a new discussion).
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

files
Files to attach to the Message (Files must belong to the same Project as the Message).
  • fileid/s - File ID or List of File IDs
    Example: 1,2
notifications
default: true
Notifications (Available when starting a new discussion).
  • true - Enable Email Notifications
  • false - Disable Email Notifications
public
default: true
Public Discussion.
  • true - Make Discussion Public
  • false - Make Discussion Private

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Quotes for a Project

This call returns a list of Quotes for a Project based on the filters specified and optionally subtotals based on the grouping options specified, it also returns the totals of all the returned quotes. The subtotals parameter allows you to return Sub Totals of quoted amounts. The fields parameter allows you to return individual Quotes and choose which data fields to return for each Quote. This call does not return details of the individual lines for each Quote, you can use the specific Quote call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: number,title,status,quoteddate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approveddate
    • company
    • dates (quoted/valid to/approved)
    • emaileddate
    • emailedto
    • lastmodified
    • number
    • project (project id/title/number)
    • quotedby
    • quoteddate
    • status
    • taxable
    • title
    • totals
    • type
    • validtodate
    Example: number,title,company
  • none - return only Totals/Subtotals
subtotals
Sub Totals - specify required subtotals, if not specified then only Fields/Totals will be returned.
  • Comma separated list of any of the following in the required order:
    • company
    • project
    • status

    • day
    • week
    • month
    • year
    Use the 'subtotalsdateoption' to specify whether to group by approved or quoted date (if week is used then the 'approveddatefrom' or 'quoteddatefrom' date will be used as the first day of the week).
    Example: company,month - return Sub Totals of Quoted amounts for each combination of Company and Month.
    NOTE - Only non-zero Sub Totals will be returned.
    IMPORTANT - To use date grouping options you must specify 'approveddatefrom' or 'quoteddatefrom' depending on the option user for 'subtotalsdateoption'.

OPTIONAL PARAMETERS:

subtotalsdateoption
default: quoted
Sub Totals Date Option - specify the date to group by when using a date option in the 'subtotals' option.
  • approved - Group by Approved Date
  • quoted - Group by Quoted Date

FILTER PARAMETERS:

apifields
API Field Value/s.
  • apifieldid,string - An API Field ID and String separated by a comma (Example: 2,Europe) - Quotes where the field contains the specified string
  • Multiple API Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Quotes where ANY of the specified apifields match
  • all - Quotes where ALL of the specified apifields match
approveddatefrom
Quotes approved on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
approveddateto
Quotes approved on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
grandtotal
Quote grandtotal.
  • number - Quote Grand Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Grand Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Grand Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
quoteddatefrom
Quotes created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
quoteddateto
Quotes created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
searchnumber
Search string.
  • string - Quotes where Number contains string
    Example: website
  • !string - Quotes where Number does not contain string
    Example: !layout
searchtitle
Search string.
  • string - Quotes where Title contains string
    Example: website
  • !string - Quotes where Title does not contain string
    Example: !layout
status
default: all
Quote Status.
  • pending - Pending Quotes
  • approved - Approved Quotes
  • active - Pending and Approved Quotes
  • declined - Declined Quotes
  • all - All Quotes
subtotal
Quote Sub Total.
  • number - Quote Sub Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Sub Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Sub Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
taxable
default: all
Taxable status.
  • true - Taxable Quotes
  • false - Non-Taxable Quotes
  • all - All Quotes
taxtotal
Quote Tax Total.
  • number - Quote Tax Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Tax Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Tax Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
type
default: all
Quote Type.
  • estimate - Estimates
  • quote - Quotes
  • all - Estimates and Quotes
validtodatefrom
Quotes valid to/after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
validtodateto
Quotes valid to/before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Quotes.
Example: pagenumber=2&pagesize=10 (return Quotes 11-20). (Paging options are not available if you are using the 'subtotals' option)
  • pagenumber
pagesize
Page Size (must be used with pagenumber). (Paging options are not available if you are using the 'subtotals' option)
  • pagesize
sortby
default: number
Sort field.
  • id - Quote ID
  • number - Quote Title
  • title - Quote Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Quote

This call adds a simple Quote to a Project. You must specify ONE of lineitems or taskrates or staffrates.
Show Sample POST data

{
   "title":"New Quote",
   "number":"auto",
   "description":"Quote Description",
   "contactid":1,
   "lines":
   [
      {
         "type":"heading",
         "name":"Redesign Work"
      },
      {
         "type":"lineitem",
         "name":"Line Item 1",
         "quantity":1,
         "rate":100.00,
         "taxable":true
      },
      {
         "type":"taskrate",
         "name":"Task Rate",
         "time":60,
         "rate":100.00,
         "taxable":false
      },
      {
         "type":"staffrate",
         "name":"Alex Trip",
         "time":60,
         "rate":100.00,
         "taxable":false
      }
   ]
}

REQUIRED PARAMETERS:

contactid
Client Contact ID.
  • contactid - Contact ID
    Example: 1
lines
Line/s.
  • lines - Line/s

    The 'type' must be specified, the following must then be specified depending on the 'type':
    • 'heading' - Must provide 'name'
    • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
    • 'staffrate' - Must provide 'name', 'time' & 'rate'
    • 'taskrate' - Must provide 'name', 'time' & 'rate'
    Example:
    [
       {
          "type":"heading",
          "name":"Redesign Work"
       },
       {
          "type":"lineitem",
          "name":"Line Item 1",
          "name":"Line Item 1 Description",
          "quantity":1,
          "rate":100.00,
          "taxable":true
       },
       {
          "type":"taskrate",
          "name":"Task Rate",
          "time":60,
          "rate":100.00,
          "taxable":false
       },
       {
          "type":"staffrate",
          "name":"Alex Trip",
          "time":60,
          "rate":100.00,
          "taxable":false
       }
    ]
title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
clientview
default: false
Client View.
  • true - Client can view Quote
  • false - Client cannot view Quote
companyname
Address Company Name.
  • companyname - Address Line 2
    Example: ABC Ltd
contactname
Address Contact Name.
  • contactname - Address Line 1
    Example: Amy Adams
country
Country.
  • country - Country
    Example: Someland
customfieldvalue
Custom Field Value.
  • customfieldvalue - Custom Field Value
    Example: Sample Value
description
Description.
  • description - Description
    Example: Sample Description
discountdescription
default: Discount
Discount Description.
  • discountdescription - Discount Description
    Example: Sample Discount
discountvalue
Discount Value.
  • number - Apply a Fixed Value Discount
    Example: 500
  • number% - Apply a percentage Discount
    Example: 10%
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering
quotedby
Quoted By.
  • quotedby - Quoted By
    Example: Amy Adams
quoteddate
Quoted Date (defaults to current date)
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
showcostbreakdown
default: true
Show Cost Breakdown (in main application).
  • true - Show Cost Breakdown
  • false - Hide Cost Breakdown
state
State.
  • state - State
    Example: Somewhere
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable
taxrate
Tax rate (overrides default rate).
  • number - Tax Rate (%)
    Example: 12.5
type
default: quote
Quote Type.
  • estimate - Estimate
  • quote - Quote
validtodate
Valid To Date (if not specified then this will be calculated automatically from Quoted Date and default payment settings).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Reactivate a Project

This call reactivates a single Project, this does NOT reactivate Tasks in the Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Project Settings

This call returns the Settings of a single Project, most settings refer to whether that module is enabled, some refer to specific settings such as whether Client Access is enabled.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit Project Settings

This call updates the Settings of a single Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

bookmarks
Bookmarks (true/false to enable/disable Bookmarks module).
  • true - Enable Bookmarks module
  • false - Disable Bookmarks module
clientaccess
Client Access (true/false to set whether Client can View this Project).
  • true - Client can View Project
  • false - Client cannot View Project
clientviewalltasks
Client View All Tasks (true/false to set whether Client can View all Tasks).
  • true - Client can View All Tasks
  • false - Client can only View Tasks they are assigned to
clientviewtime
Client View Time (true/false to set whether Client can View Time Information).
  • true - Client can View Time Information
  • false - Client cannot View Time Information
customfields
Custom Fields (Advanced Plan only - true/false to enable/disable Custom Fields module).
  • true - Enable Custom Fields module
  • false - Disable Custom Fields module
customform
Custom Form (Advanced Plan only - true/false to enable/disable Custom Form module).
  • true - Enable Custom Form module
  • false - Disable Custom Form module
description
Description (true/false to enable/disable Description module).
  • true - Enable Description module
  • false - Disable Description module
emailalerts
Email Alerts (true/false to set whether Email Alerts are sent for activity in this Project).
  • true - Send Email Alerts
  • false - Don't Send Email Alerts
expenses
Expenses (true/false to enable/disable Expenses module).
  • true - Enable Expenses module
  • false - Disable Expenses module
files
Files (true/false to enable/disable Files module).
  • true - Enable Files module
  • false - Disable Files module
invoices
Invoices (true/false to enable/disable Invoices module, only available when Invoices plugin is enabled for account).
  • true - Enable Invoices module
  • false - Disable Invoices module
messages
Messages (true/false to enable/disable Messages module).
  • true - Enable Messages module
  • false - Disable Messages module
privatenotes
Private Notes (true/false to enable/disable Private Notes module).
  • true - Enable Private Notes module
  • false - Disable Private Notes module
quotes
Quotes (true/false to enable/disable Quotes module, only available when Quotes plugin is enabled for account).
  • true - Enable Quotes module
  • false - Disable Quotes module
sharednotes
Shared Notes (true/false to enable/disable Shared Notes module).
  • true - Enable Shared Notes module
  • false - Disable Shared Notes module
smartordering
Smart Ordering (true/false to set whether Task Smart Ordering is enabled).
  • true - Enable Smart Ordering
  • false - Disable Smart Ordering
staffviewallmessages
Staff View All Messages (true/false to set whether Staff can View all Messages).
  • true - Staff can View All Messages
  • false - Staff can only View Messages that are sent to/by them or that have been made Public
staffviewalltasks
Staff View All Tasks (true/false to set whether Staff can View all Tasks).
  • true - Staff can View All Tasks
  • false - Staff can only View Tasks they are assigned to
tasks
Tasks (true/false to enable/disable Tasks module).
  • true - Enable Tasks module
  • false - Disable Tasks module
timeline
Timeline (true/false to enable/disable Timeline module).
  • true - Enable Timeline module
  • false - Disable Timeline module
timesummary
Time Summary (true/false to enable/disable Time Summary module).
  • true - Enable Time Summary module
  • false - Disable Time Summary module

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Shared Notes

This call returns a list of Shared Notes for a Project based on the filters specified. The fields parameter allows you to choose which data fields to return for each Shared Note.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: content,title
Fields to return.
  • Comma separated list of any of the following:
    • company
    • content
    • project(includes id/number/title)
    • title
    Example: content,title

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

search
Search string.
  • string - Notes where Title contains string
    Example: website
  • !string - Notes where Title does not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Notes.
Example: pagenumber=2&pagesize=10 (return Notes 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - Note ID
  • projectid - Project ID
  • title - Note Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Shared Note

This call adds a single Shared Note to a Project.
Show Sample POST data

{
   "projectid":1,
   "title":"New Shared Note",
   "content":"Note Description"
}

REQUIRED PARAMETERS:

title
Title.
  • title - Title
    Example: Sample Title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

content
Content.
  • content - Content
    Example: Sample Description

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Tasks for a Project

This call returns details of the Tasks for a Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,type,order,status,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • billable
    • burn (returns budget/burn/totalburn where burn reflects the burn based on any time-based filters)
    • category
    • company
    • completedate
    • contacts
    • creator
    • (contact who added this Task)
    • dates (returns start/due/complete)
    • dependent (returns currenttask status and prerequisites)
    • description
    • duedate
    • lastmodified
    • name
    • order
    • priority
    • service (returns servicedescription/servicename/servicerate)
    • status
    • tags
    • tasklist
    • taxable
    • timeallocated
    • timetracked
    • type
    Example: order,name,project

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Tasks where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Tasks where ANY of the specified apifields match
  • all - Tasks where ALL of the specified apifields match
billable
default: all
Billable status.
  • true - Billable Tasks
  • false - Non-Billable Tasks
  • all - All Tasks
completedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Tasks assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • me - Tasks assigned to Contact making request
  • unassigned - Unassigned Tasks
  • all - All Tasks
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Tasks assigned to ANY of the specified contacts
  • all - Tasks assigned to ALL of the specified contacts
divisionid
Division ID (Advanced plan only).
  • divisionid - Tasks in specified Division
    Example: 1
duedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
idfrom
Tasks with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Tasks with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Tasks added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Tasks added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Tasks added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Tasks added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
priority
Priority (1-5 representing Very High-Very Low).
  • priority/ies - Tasks with specified Priority/ies
    Example: 1,2
  • !priority/ies - Tasks NOT with specified Priority/ies
    Example: !4,5
projectstatus
default: all
Project Status.
  • active - Tasks in Active Projects
  • complete - Tasks in Completed Projects
  • all - Tasks in All Projects
searchdescription
Search Description.
  • string - Tasks where Description contains string
    Example: website
  • !string - Tasks where Description does not contain string
    Example: !layout
searchname
Search Name.
  • string - Tasks where Name contains string
    Example: website
  • !string - Tasks where Name does not contain string
    Example: !layout
startdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Task Status.
  • active - Active Tasks
  • complete - Completed Tasks
  • all - All Tasks
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timetracked
Tasks where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto parameters apply to the starred options.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
type
default: all
Task Type.
  • normal - Normal Tasks
  • bold - Bold Tasks
  • heading - Heading Tasks
  • nonheading - Non-Heading Tasks (Normal + Bold)
  • all - All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Tasks.
Example: pagenumber=2&pagesize=10 (return Tasks 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - ID
  • order - Order
  • name - Name
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • projectid - Project ID
  • projectnumber - Project Number
  • projecttitle - Project Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Task/s

This call adds a Task/s to a Project.
You must either provide details for one or more Tasks or specify a Task Template ID.
If 'order' is not specified then the Task/s will be added as the last Task/s on the Project. Please refer to the 'order' parameter for further details on available options.
When specifying a Task Template ID you can specify 'startdate' to set the date corresponding to day 1 in the Template or 'duedate' to set the date corresponding to the latest day in the Template. If Smart Ordering is enabled for the Project then you can use the 'order' setting to choose where to insert the Template. When using a Template you can set the 'addtemplatecontacts' option to choose whether Contacts in the Template who are not assigned to the Project should be added or ignored.
IMPORTANT: When adding multiple Tasks each Task must have the same 'order' option or have a specific order number. When multiple Tasks are added using 'auto/after/before' 'order' options then they are added to the project in the order they are provided in your data.
Show Sample POST data

Single Task:
{
   "name":"Adam",
   "contacts":"1,2",
   "startdate":"2014-01-18"
}

Multiple Tasks:
[
   {
      "name":"Adam",
      "priority":2,
      "contacts":"me",
      "startdate":"2014-01-18"
   },
   {
      "name":"Bob",
      "contacts":"allstaff",
      "startdate":"2014-01-23"
   },
   {
      "name":"Charles",
      "contacts":"1,2,3",
      "startdate":"2014-01-28"
   }
]

Task Template:
{
   "templateid":1,
   "startdate":"2014-01-18",
   "addtemplatecontacts":false
}

REQUIRED PARAMETERS:

contacts
default: me
Assigned Contacts.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Contacts assigned to Project (Project Tasks) or All Staff (General Tasks)
  • allstaff - All Staff assigned to Project (Project Tasks) or All Staff (General Tasks)
  • none - No Contacts (we recommend not using this option unless essential)
name
Name.
  • name - Name
    Example: Sample Name
servicename
Service Name.
  • servicename - Name
    Example: Sample Name
templateid
Task Template ID.
  • templateid - Task Template ID
    Example: 1

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

addtemplatecontacts
default: true
Assign Template Contacts to Project
  • true - Contacts in the Template will be assigned to the Project
  • false - Contacts not assigned to the Project will be ignored in the Template
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
    { "id":1, "value":"Europe"},
    { "id":2, "value":"Industrial"}
    ]
billable
default: true
Billable (true/false to set whether Task is billable).
  • true - Billable
  • false - Not billable
completedate
Complete Date, if specified then the Task will be added with a Completed status (alerts are not sent when adding Completed Tasks).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
description
Description.
  • description - Description
    Example: Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
order
default: auto
Order
  • auto - Add as last Task in Project (set 'orderlevel' to add as a sub task or sub sub task). If no Tasks exist or adding a general task then the order number will be 1/1.1/1.1.1 depending on 'orderlevel'.
  • aftertaskid - Add after 'taskid' in Project (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically. Only available when adding Tasks to a Project.
    IMPORTANT: Only available when Smart Ordering is enabled for the Project.
    Example: after1
  • beforetaskid - Add before 'taskid' in Project (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically. Only available when adding Tasks to a Project.
    IMPORTANT: Only available when Smart Ordering is enabled for the Project.
    Example: before1
  • ordernumber - Add Task with order number 'ordernumber', if adding to a Project and compulsory task ordering is enabled then you must specify an order number not already in use in the Project.
    IMPORTANT: This option will NOT reorder any existing tasks.
    Example: 1.1
orderlevel
default: normal
Order Level (used when 'order' is set to 'auto', 'aftertaskid' or 'beforetaskid')
  • normal - normal (top level) task
  • sub - sub task
  • subsub - sub sub task
prerequisites
Prerequisite Tasks (this clears any previous dependencies)
  • taskid/s - Task ID or List of Task IDs in the same Project as this Task or reference new Tasks added at the same time as this task using newX for the Xth new task.
    Example: 1,2,new2
  • none - Remove existing prerequisites
priority
default: 3
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
servicedescription
Service Description.
  • servicedescription - Description
    Example: Sample Description
servicerate
Service Rate (Cost per hour).
  • servicerate - Rate
    Example: 150.00
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taxable
default: true
Taxable (true/false to set whether Task is taxable).
  • true - Taxable
  • false - Not taxable
timeallocated
default: 0
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300
type
default: normal
Type')
  • normal - normal task
  • bold - bold task
  • heading - heading task

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Time for a Project

This call returns details of Time for a Project based on the filters specified. The subtotals parameter allows you to return Sub Totals of time tracked. The fields parameter allows you to return individual Time Records and choose which data fields to return for each Time Record.

REQUIRED PARAMETERS:

trackedfrom
default: -6d
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
trackedto
default: +0d
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FIELD PARAMETERS:

fields
Fields to return - if not specified then only Total/Sub Totals will be returned.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approvalstatus
    • billable
    • category (Project Category)
    • company
    • contact
    • dates
    • lastmodified
    • notes
    • project
    • task
    • tasktimetotals (Total allocated/tracked time for the task)
    • timetracked
    Example: contact,task,timetracked
  • none - return only Total/Subtotals
subtotals
Sub Totals - if not specified then only Total/Fields will be returned.
  • Comma separated list of any of the following in the required order:
    • billable
    • category
    • company
    • contact
    • group (Advanced plan only, Group in charge of Project)
    • internalclientgroup (Advanced plan only, Group of Internal Client for Project)
    • internalclientteam (Advanced plan only, Team of Internal Client for Project)
    • project
    • task
    • team (Advanced plan only, Team in charge of Project)

    • day
    • week
    • month
    • year
    • If week is used then the 'trackedfrom' date will be used as the first day of the week.
      Example: contact,company - return Sub Totals of Time Tracked for each combination of Contact and Company.
      NOTE - Only non-zero Sub Totals will be returned.

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

approvalstatus
default: all
Approval Status.
  • approved - Approved Time Records
  • locked - Locked Time Records
  • submitted - Submitted Time Records
  • open - Open Time Records (Not approved, locked or submitted)
  • closed - Closed Time Records (Approved, locked or submitted)
  • all - All Time Records
billable
default: all
Billable status.
  • billable - Billable Time
  • nonbillable - Non-Billable Time
  • all - All Time
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • me - Time Tracked by Contact making request
  • all - Time Tracked by All Contact
taskcompletedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskcompletedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskstartdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskstartdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

sortby
default: id
Sort field for Time Records.
  • id - Time Record ID
  • date - Time Record Date
  • taskid - Task ID
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Overdue Projects

This call returns a list of Active Overdue Projects based on the filters specified. The fields parameter allows you to choose which data fields to return for each Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,number,company,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • accountedfor (Accounted For Status - true/false)
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • category
    • company (for internal Projects in the Advanced plan, this will also return internalclientteamid, internalclientteamname, internalclientgroupid and internalclientgroupname)
    • completedate
    • contacts (returns clients/contractors/manager/staff)
    • customfields (Advanced plan only)
    • customform (Advanced plan only)
    • customstatus (Advanced plan only)
    • dates (returns start/due/complete)
    • description
    • duedate
    • expensestotal
    • group (Advanced plan only)
    • invoiced (Invoiced Status - true/false)
    • invoicetotal
    • lastmodified
    • manager
    • number
    • paid (Paid Status - true/false)
    • percentcomplete (percentage of tasks completed, heading tasks excluded)
    • priority
    • privatenotes (staff only)
    • purchaseordernumber
    • quotetotal
    • startdate
    • status
    • tags
    • team (Advanced plan only)
    • timeallocated
    • timetracked
    • title
    • type
    • (Advanced plan only, returns 'internal' or 'external')
    Example: number,title,company

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

accountedfor
default: all
Accounted For Status.
  • accountedfor - Projects marked as Accounted For
  • unaccountedfor - Projects marked as Unaccounted For
  • all - All Projects
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Projects where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Projects where ANY of the specified apifields match
  • all - Projects where ALL of the specified apifields match
categoryid
Category ID or List of Category IDs.
  • categoryid/s - Projects in specified Category/ies
    Example: 1,2,3
  • !categoryid/s - Projects NOT in specified Category/ies
    Example: !1,2,3
companyid
Company ID or List of Company IDs.
  • companyid/s - Projects in specified Company/ies
    Example: 1,2,3
  • !companyid/s - Projects NOT for specified Company/ies
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Projects assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Projects NOT assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: !1,2
  • me - Projects assigned to Contact making request
  • all - All Projects
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Projects assigned to ANY of the specified contacts
  • all - Projects assigned to ALL of the specified contacts
customfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
customfieldsmode
default: any
Mode used for the customfields parameter.
  • any - Projects where ANY of the specified customfields match
  • all - Projects where ALL of the specified customfields match
customstatusid
Custom Status ID or List of Custom Status IDs (Advanced plan only).
  • customstatusid/s - Projects with specified Custom Status/es
    Example: 1,2
  • !customstatusid/s - Projects without specified Custom Status/es
    Example: !1,2
divisionid
Division ID (Advanced plan only).
  • divisionid - Projects in specified Division
    Example: 1
groupid
Group (Advanced plan only).
  • groupid/s - Group ID or List of Group IDs - Projects Managed by any of the specified Group/s
    Example: 1,2
  • !groupid/s - Group ID or List of Group IDs - Projects NOT Managed by any of the specified Group/s
    Example: !1,2
invoiced
default: all
Invoiced Status.
  • invoiced - Projects marked as Invoiced
  • uninvoiced - Projects marked as Uninvoiced
  • all - All Projects
invoicetotal
Projects where Invoice Total matches criteria.
  • number - Invoice Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Invoice Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Invoice Total is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Invoice Total is GREATER THAN Quote Total (Projects with 0 Quote Total ignored)
  • under - Invoice Total is LESS THAN OR EQUAL TO Quote Total (Projects with 0 Quote Total ignored)
  • gtenumber% - Invoice Total is GREATER THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: gte30%
  • ltenumber% - Invoice Total is LESS THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: lte30%
managerid
default: all
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Projects Managed by any of the specified Contact/s
    Example: 1,2
  • !managerid/s - Contact ID or List of Contact IDs - Projects NOT Managed by any of the specified Contact/s
    Example: !1,2
  • me - Projects Managed by Contact making request
  • all - All Projects
paid
default: all
Paid Status.
  • paid - Projects marked as Paid
  • unpaid - Projects marked as Unpaid
  • all - All Projects
priority
Priority or List of Priorities (1-5 representing Very High-Very Low).
  • priority/ies - Projects with specified Priority/ies
    Example: 1,2
  • !priority/ies - Projects NOT with specified Priority/ies
    Example: !4,5
quotetotal
Projects where Quote Total matches criteria.
  • number - Quote Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Quote Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Quote Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
search
Search.
  • string - Projects where Number or Title contains string
    Example: website
  • !string - Projects where Number and Title do not contain string
    Example: !layout
searchcustomform
Search Custom Form (Advanced plan only).
  • string - Projects where Custom Form contains string
    Example: website
  • !string - Projects where Custom Form does not contain string
    Example: !layout
searchdescription
Search Description.
  • string - Projects where Description contains string
    Example: website
  • !string - Projects where Description does not contain string
    Example: !layout
searchnumber
Search Name.
  • string - Projects where Number contains string
    Example: website
  • !string - Projects where Number does not contain string
    Example: !layout
searchtitle
Search Title.
  • string - Projects where Title contains string
    Example: website
  • !string - Projects where Title does not contain string
    Example: !layout
startdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Projects with specified Tag/s
    Example: 1,2,3
  • !tagid/s - Projects without specified Tag/s
    Example: !1,2,3
teamid
Team (Advanced plan only).
  • teamid/s - Team ID or List of Team IDs - Projects Managed by any of the specified Team/s
    Example: 1,2
  • !teamid/s - Team ID or List of Team IDs - Projects NOT Managed by any of the specified Team/s
    Example: !1,2
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timebillable
default: all
Billable/Non-billable/All Time Tracked.
  • all - All Time
  • billable - Billable Time only
  • nonbillable - Non-billable Time only
timetracked
Projects where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto and timebillable parameters will apply to the starred options.
IMPORTANT: The non-starred options will always use the Total Time Tracked (all contacts, dates, billable status) for comparison.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Projects.
Example: pagenumber=2&pagesize=10 (return Projects 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: number
Sort field.
  • id - ID
  • title - Title
  • number - Number
  • startdate - Start Date
  • duedate - Due Date
  • companyid - Company ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Overtime Projects

This call returns a list of Overtime Projects based on the filters specified. The fields parameter allows you to choose which data fields to return for each Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,number,company,startdate,duedate,timeallocated,timetracked
Fields to return.
  • Comma separated list of any of the following:
    • accountedfor (Accounted For Status - true/false)
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • category
    • company (for internal Projects in the Advanced plan, this will also return internalclientteamid, internalclientteamname, internalclientgroupid and internalclientgroupname)
    • completedate
    • contacts (returns clients/contractors/manager/staff)
    • customfields (Advanced plan only)
    • customform (Advanced plan only)
    • customstatus (Advanced plan only)
    • dates (returns start/due/complete)
    • description
    • duedate
    • expensestotal
    • group (Advanced plan only)
    • invoiced (Invoiced Status - true/false)
    • invoicetotal
    • lastmodified
    • manager
    • number
    • paid (Paid Status - true/false)
    • percentcomplete (percentage of tasks completed, heading tasks excluded)
    • priority
    • privatenotes (staff only)
    • purchaseordernumber
    • quotetotal
    • startdate
    • status
    • tags
    • team (Advanced plan only)
    • timeallocated
    • timetracked
    • title
    • type
    • (Advanced plan only, returns 'internal' or 'external')
    Example: number,title,company

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

accountedfor
default: all
Accounted For Status.
  • accountedfor - Projects marked as Accounted For
  • unaccountedfor - Projects marked as Unaccounted For
  • all - All Projects
apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Projects where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Projects where ANY of the specified apifields match
  • all - Projects where ALL of the specified apifields match
categoryid
Category ID or List of Category IDs.
  • categoryid/s - Projects in specified Category/ies
    Example: 1,2,3
  • !categoryid/s - Projects NOT in specified Category/ies
    Example: !1,2,3
companyid
Company ID or List of Company IDs.
  • companyid/s - Projects in specified Company/ies
    Example: 1,2,3
  • !companyid/s - Projects NOT for specified Company/ies
completedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Projects assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Projects NOT assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: !1,2
  • me - Projects assigned to Contact making request
  • all - All Projects
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Projects assigned to ANY of the specified contacts
  • all - Projects assigned to ALL of the specified contacts
customfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
customfieldsmode
default: any
Mode used for the customfields parameter.
  • any - Projects where ANY of the specified customfields match
  • all - Projects where ALL of the specified customfields match
customstatusid
Custom Status ID or List of Custom Status IDs (Advanced plan only).
  • customstatusid/s - Projects with specified Custom Status/es
    Example: 1,2
  • !customstatusid/s - Projects without specified Custom Status/es
    Example: !1,2
divisionid
Division ID (Advanced plan only).
  • divisionid - Projects in specified Division
    Example: 1
duedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
groupid
Group (Advanced plan only).
  • groupid/s - Group ID or List of Group IDs - Projects Managed by any of the specified Group/s
    Example: 1,2
  • !groupid/s - Group ID or List of Group IDs - Projects NOT Managed by any of the specified Group/s
    Example: !1,2
invoiced
default: all
Invoiced Status.
  • invoiced - Projects marked as Invoiced
  • uninvoiced - Projects marked as Uninvoiced
  • all - All Projects
invoicetotal
Projects where Invoice Total matches criteria.
  • number - Invoice Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Invoice Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Invoice Total is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Invoice Total is GREATER THAN Quote Total (Projects with 0 Quote Total ignored)
  • under - Invoice Total is LESS THAN OR EQUAL TO Quote Total (Projects with 0 Quote Total ignored)
  • gtenumber% - Invoice Total is GREATER THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: gte30%
  • ltenumber% - Invoice Total is LESS THAN OR EQUAL to specified percentage of Quote Total (Projects with 0 Quote Total ignored)
    Example: lte30%
managerid
default: all
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Projects Managed by any of the specified Contact/s
    Example: 1,2
  • !managerid/s - Contact ID or List of Contact IDs - Projects NOT Managed by any of the specified Contact/s
    Example: !1,2
  • me - Projects Managed by Contact making request
  • all - All Projects
paid
default: all
Paid Status.
  • paid - Projects marked as Paid
  • unpaid - Projects marked as Unpaid
  • all - All Projects
priority
Priority or List of Priorities (1-5 representing Very High-Very Low).
  • priority/ies - Projects with specified Priority/ies
    Example: 1,2
  • !priority/ies - Projects NOT with specified Priority/ies
    Example: !4,5
quotetotal
Projects where Quote Total matches criteria.
  • number - Quote Total is EXACTLY the specified value
    Example: 300
  • gtenumber - Quote Total is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Quote Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
search
Search.
  • string - Projects where Number or Title contains string
    Example: website
  • !string - Projects where Number and Title do not contain string
    Example: !layout
searchcustomform
Search Custom Form (Advanced plan only).
  • string - Projects where Custom Form contains string
    Example: website
  • !string - Projects where Custom Form does not contain string
    Example: !layout
searchdescription
Search Description.
  • string - Projects where Description contains string
    Example: website
  • !string - Projects where Description does not contain string
    Example: !layout
searchnumber
Search Name.
  • string - Projects where Number contains string
    Example: website
  • !string - Projects where Number does not contain string
    Example: !layout
searchtitle
Search Title.
  • string - Projects where Title contains string
    Example: website
  • !string - Projects where Title does not contain string
    Example: !layout
startdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Status.
  • active - Active Projects
  • complete - Completed Projects
  • all - All Projects
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Projects with specified Tag/s
    Example: 1,2,3
  • !tagid/s - Projects without specified Tag/s
    Example: !1,2,3
teamid
Team (Advanced plan only).
  • teamid/s - Team ID or List of Team IDs - Projects Managed by any of the specified Team/s
    Example: 1,2
  • !teamid/s - Team ID or List of Team IDs - Projects NOT Managed by any of the specified Team/s
    Example: !1,2
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timebillable
default: all
Billable/Non-billable/All Time Tracked.
  • all - All Time
  • billable - Billable Time only
  • nonbillable - Non-billable Time only
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Projects.
Example: pagenumber=2&pagesize=10 (return Projects 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: number
Sort field.
  • id - ID
  • title - Title
  • number - Number
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • companyid - Company ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending

DELETE PUT POST GET

Staff
Client
Contractor
View Quotes/Totals

This call returns a list of Quotes based on the filters specified and optionally subtotals based on the grouping options specified, it also returns the totals of all the returned quotes. The subtotals parameter allows you to return Sub Totals of quoted amounts. The fields parameter allows you to return individual Quotes and choose which data fields to return for each Quote. This call does not return details of the individual lines for each Quote, you can use the specific Quote call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: number,title,company,status,totals,quoteddate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approveddate
    • company
    • customfield (returns customfieldname and customfieldvalue)
    • dates (quoted/valid to/approved)
    • description
    • emaileddate
    • emailedto
    • lastmodified
    • number
    • project (project id/title/number)
    • quotedby
    • quoteddate
    • showcostbreakdown
    • status
    • taxable
    • taxrate
    • title
    • totals (sub/tax/grand totals)
    • type
    • validtodate
    Example: number,title,company
  • none - return only Totals/Subtotals
subtotals
Sub Totals - specify required subtotals, if not specified then only Fields/Totals will be returned.
  • Comma separated list of any of the following in the required order:
    • company
    • project
    • status

    • day
    • week
    • month
    • year
    Use the 'subtotalsdateoption' to specify whether to group by approved or quoted date (if week is used then the 'approveddatefrom' or 'quoteddatefrom' date will be used as the first day of the week).
    Example: company,month - return Sub Totals of Quoted amounts for each combination of Company and Month.
    NOTE - Only non-zero Sub Totals will be returned.
    IMPORTANT - To use date grouping options you must specify 'approveddatefrom' or 'quoteddatefrom' depending on the option user for 'subtotalsdateoption'.

OPTIONAL PARAMETERS:

subtotalsdateoption
default: quoted
Sub Totals Date Option - specify the date to group by when using a date option in the 'subtotals' option.
  • approved - Group by Approved Date
  • quoted - Group by Quoted Date

FILTER PARAMETERS:

apifields
API Field Value/s.
  • apifieldid,string - An API Field ID and String separated by a comma (Example: 2,Europe) - Quotes where the field contains the specified string
  • Multiple API Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Quotes where ANY of the specified apifields match
  • all - Quotes where ALL of the specified apifields match
approveddatefrom
Quotes approved on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
approveddateto
Quotes approved on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
companyid
Company ID or List of Company IDs.
  • companyid/s - Quotes in specified Company/ies
    Example: 1,2,3
divisionid
Division ID (Advanced plan only).
  • divisionid - Quotes in specified Division
    Example: 1
grandtotal
Quote grandtotal.
  • number - Quote Grand Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Grand Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Grand Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
id
List of Quote IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Quotes with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Quotes with ID greater than or equal to this value .
  • id - ID
    Example: 1
lastmodifiedfrom
Quotes added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Quotes added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Quotes added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Quotes added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Quotes in Projects managed by specified Contact/s
    Example: 1,2
  • me - Quotes in Projects managed by Contact making request
projectcategoryid
Project Category ID or List of Project Category IDs.
  • projectcategoryid/s - Quotes in Projects in specified Category/ies
    Example: 1,2,3
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Quotes for specified Project/s
    Example: 1,2
projectstatus
default: all
Project Status.
  • active - Quotes in Active Projects
  • complete - Quotes in Completed Projects
  • all - Quotes in All Projects
quoteddatefrom
Quotes created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
quoteddateto
Quotes created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
search
Search string.
  • string - Quotes where Number or Title contains string
    Example: website
  • !string - Quotes where Number and Title do not contain string
    Example: !layout
searchdescription
Search string.
  • string - Quotes where Description contains string
    Example: website
  • !string - Quotes where Description does not contain string
    Example: !layout
searchnumber
Search string.
  • string - Quotes where Number contains string
    Example: website
  • !string - Quotes where Number does not contain string
    Example: !layout
searchquotedby
Search string.
  • string - Quotes where Quoted By contains string
    Example: website
  • !string - Quotes where Quoted By does not contain string
    Example: !layout
searchtitle
Search string.
  • string - Quotes where Title contains string
    Example: website
  • !string - Quotes where Title does not contain string
    Example: !layout
status
default: pending
Quote Status.
  • pending - Pending Quotes
  • approved - Approved Quotes
  • active - Pending and Approved Quotes
  • declined - Declined Quotes
  • all - All Quotes
subtotal
Quote Sub Total.
  • number - Quote Sub Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Sub Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Sub Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
taxable
default: all
Taxable status.
  • true - Taxable Quotes
  • false - Non-Taxable Quotes
  • all - All Quotes
taxtotal
Quote Tax Total.
  • number - Quote Tax Total is EXACTLY the specified value
    Example: 3000.00
  • gtenumber - Quote Tax Total is GREATER THAN OR EQUAL to specified value
    Example: gte3000.00
  • ltenumber - Quote Tax Total is LESS THAN OR EQUAL to specified value
    Example: lte3000.00
type
default: all
Quote Type.
  • estimate - Estimates
  • quote - Quotes
  • all - Estimates and Quotes
validtodatefrom
Quotes valid to/after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
validtodateto
Quotes valid to/before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Quotes.
Example: pagenumber=2&pagesize=10 (return Quotes 11-20). (Paging options are not available if you are using the 'subtotals' option).
  • pagenumber
pagesize
Page Size (must be used with pagenumber). (Paging options are not available if you are using the 'subtotals' option).
  • pagesize
sortby
default: number
Sort field.
  • companyname - Company Name
  • id - Quote ID
  • number - Quote Number
  • quoteddate - Quoted Date
  • title - Quote Title
  • validtodate - Valid to Date
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Quote

This call adds a simple quote.
Show Sample POST data

{
   "title":"New Quote",
   "number":"auto",
   "description":"Quote Description",
   "contactid":1,
   "projectid":2,
   "lines":
   [
      {
         "type":"heading",
         "name":"Redesign Work"
      },
      {
         "type":"lineitem",
         "name":"Line Item 1",
         "quantity":1,
         "rate":100.00,
         "taxable":true
      },
      {
         "type":"taskrate",
         "name":"Task Rate",
         "time":60,
         "rate":100.00,
         "taxable":false
      },
      {
         "type":"staffrate",
         "name":"Alex Trip",
         "time":60,
         "rate":100.00,
         "taxable":false
      }
   ]
}

REQUIRED PARAMETERS:

contactid
Client Contact ID.
  • contactid - Contact ID
    Example: 1
lines
Line/s.
  • lines - Line/s

    The 'type' must be specified, the following must then be specified depending on the 'type':
    • 'heading' - Must provide 'name'
    • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
    • 'staffrate' - Must provide 'name', 'time' & 'rate'
    • 'taskrate' - Must provide 'name', 'time' & 'rate'
    Example:
    [
       {
          "type":"heading",
          "name":"Redesign Work"
       },
       {
          "type":"lineitem",
          "name":"Line Item 1",
          "name":"Line Item 1 Description",
          "quantity":1,
          "rate":100.00,
          "taxable":true
       },
       {
          "type":"taskrate",
          "name":"Task Rate",
          "time":60,
          "rate":100.00,
          "taxable":false
       },
       {
          "type":"staffrate",
          "name":"Alex Trip",
          "time":60,
          "rate":100.00,
          "taxable":false
       }
    ]
title
Title.
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
city
City.
  • city - City
    Example: Somecity
clientview
default: false
Client View.
  • true - Client can view Quote
  • false - Client cannot view Quote
companyname
Address Company Name.
  • companyname - Address Line 2
    Example: ABC Ltd
contactname
Address Contact Name.
  • contactname - Address Line 1
    Example: Amy Adams
country
Country.
  • country - Country
    Example: Someland
customfieldvalue
Custom Field Value.
  • customfieldvalue - Custom Field Value
    Example: Sample Value
description
Description.
  • description - Description
    Example: Sample Description
discountdescription
default: Discount
Discount Description.
  • discountdescription - Discount Description
    Example: Sample Discount
discountvalue
Discount Value.
  • number - Apply a Fixed Value Discount
    Example: 500
  • number% - Apply a percentage Discount
    Example: 10%
number
default: auto
Number.
  • number - Number
    Example: ABC-00001
  • auto - Use Autonumbering
projectid
Project ID.
  • projectid - Attach Quote to Project ID
    Example: 1
quotedby
Quoted By.
  • quotedby - Quoted By
    Example: Amy Adams
quoteddate
Quoted Date (defaults to current date)
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
showcostbreakdown
default: true
Show Cost Breakdown (in main application).
  • true - Show Cost Breakdown
  • false - Hide Cost Breakdown
state
State.
  • state - State
    Example: Somewhere
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable
taxrate
Tax rate (overrides default rate).
  • number - Tax Rate (%)
    Example: 12.5
type
default: quote
Quote Type.
  • estimate - Estimate
  • quote - Quote
validtodate
Valid To Date (if not specified then this will be calculated automatically from Quoted Date and default payment settings).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Quote

This call deletes a single Quote.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Quote

This call returns details of a single Quote.
IMPORTANT: For Task/Staff Rate Lines, the 'rate' value is cost/hour, the 'time' value is the time in minutes.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Quote

This call updates details of a single Quote.
IMPORTANT: If you specify any 'lines' then all existing lines will be replaced, if you want to add/edit/remove individual lines then use the dedicated 'quote/lines' or 'quote/line' calls instead.
Show Sample PUT data

{
   "status":"approved",
   "discountvalue":100,
   "discountdescription":"Discount Description",
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
approveddate
Approved Date
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
city
City.
  • city - City
    Example: Somecity
clientview
Client View.
  • true - Client can view Quote
  • false - Client cannot view Quote
companyname
Address Company Name.
  • companyname - Address Line 2
    Example: ABC Ltd
contactname
Address Contact Name.
  • contactname - Address Line 1
    Example: Amy Adams
country
Country.
  • country - Country
    Example: Someland
customfieldvalue
Custom Field Value.
  • customfieldvalue - Custom Field Value
    Example: Sample Value
description
Description.
  • description - Description
    Example: Sample Description
discountdescription
Discount Description.
  • discountdescription - Discount Description
    Example: Sample Discount
discountvalue
Discount Value.
  • number - Apply a Fixed Value Discount
    Example: 500
  • number% - Apply a percentage Discount
    Example: 10%
lines
Line/s.
  • lines - Line/s

    The 'type' must be specified, the following must then be specified depending on the 'type':
    • 'heading' - Must provide 'name'
    • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
    • 'staffrate' - Must provide 'name', 'time' & 'rate'
    • 'taskrate' - Must provide 'name', 'time' & 'rate'
    Example:
    [
       {
          "type":"heading",
          "name":"Redesign Work"
       },
       {
          "type":"lineitem",
          "name":"Line Item 1",
          "name":"Line Item 1 Description",
          "quantity":1,
          "rate":100.00,
          "taxable":true
       },
       {
          "type":"taskrate",
          "name":"Task Rate",
          "time":60,
          "rate":100.00,
          "taxable":false
       },
       {
          "type":"staffrate",
          "name":"Alex Trip",
          "time":60,
          "rate":100.00,
          "taxable":false
       }
    ]
number
Number.
  • number - Number
    Example: ABC-00001
projectid
Project ID.
  • projectid - Attach Quote to Project ID
    Example: 1
quotedby
Quoted By.
  • quotedby - Quoted By
    Example: Amy Adams
quoteddate
Quoted Date
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
showcostbreakdown
Show Cost Breakdown (in main application).
  • true - Show Cost Breakdown
  • false - Hide Cost Breakdown
state
State.
  • state - State
    Example: Somewhere
status
Status.
  • approved - Approved
  • declined - Declined
  • pending - Pending
taxable
Taxable status.
  • true - Taxable
  • false - Non-Taxable
taxrate
Tax rate.
  • number - Tax Rate (%)
    Example: 12.5
title
Title.
  • title - Title
    Example: Sample title
type
Quote Type.
  • estimate - Estimate
  • quote - Quote
validtodate
Valid To Date
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Approve a Quote

This call will approve a quote. This is currently done by a staff user on behalf of a client. You can specify 'approveddate' otherwise the current user's time is used, you can also optionally attach the Quote to a project by specifying 'projectid'.
Show Sample PUT data

{
   "approveddate":"2014-04-28"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

approveddate
Approved Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project ID.
  • projectid - Attach Quote to Project ID
    Example: 1

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Decline a Quote

This call will decline a quote. This is currently done by a staff user on behalf of a client.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Lines in a Quote

This call returns details of Lines in a Quote.
IMPORTANT: For Task/Staff Rate Lines, the 'rate' value is cost/hour, the 'time' value is the time in minutes.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add Line/s to a Quote

This call adds Line/s to a Quote.

The 'type' must be specified, the following must then be specified depending on the 'type':

  • 'heading' - Must provide 'name'
  • 'lineitem' - Must provide 'name' or 'description' as well as 'quantity' & 'rate'
  • 'staffrate' - Must provide 'name', 'time' & 'rate'
  • 'taskrate' - Must provide 'name', 'time' & 'rate'

Show Sample POST data

Single Line Item:
{
   "type":"lineitem",
   "name":"Line Item 1",
   "description":"Line Item 1 Description",
   "quantity":1,
   "rate":100.00,
   "taxable":true
}

Multiple Line Items:
[
   {
      "type":"heading",
      "name":"Redesign Work"
   },
   {
      "type":"lineitem",
      "name":"Line Item 1",
      "quantity":1,
      "rate":100.00,
      "taxable":true
   },
   {
      "type":"taskrate",
      "name":"Task Rate",
      "time":60,
      "rate":100.00,
      "taxable":false
   },
   {
      "type":"staffrate",
      "name":"Alex Trip",
      "time":60,
      "rate":100.00,
      "taxable":false
   }
]

REQUIRED PARAMETERS:

type
Type.
  • heading - Heading
  • lineitem - Line Item
  • staffrate - Staff Rate
  • taskrate - Task Rate

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

description
Description.
  • description - Description
    Example: Sample Description
displayorder
default: auto
Display Order
  • auto - Add as last Lines.
  • afterlineid - Add after 'lineid' in Quote. Any existing Lines will be reordered automatically.
    Example: after1
  • beforelineid - Add before 'lineid' in Quote. Any existing Tasks will be reordered automatically.
    Example: before1
  • number - Add Line with display order number 'number'.
    IMPORTANT: This option will NOT reorder any existing lines.
    Example: 1.1
name
Name.
  • name - Name
    Example: Sample name
quantity
Quantity.
  • quantity - Rate
    Example: 5
rate
Rate.
  • rate - Rate
    Example: 500.00
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable
time
Time (minutes).
  • time - Rate
    Example: 120

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Line from a Quote

This call delete a single Line in a Quote.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Line in a Quote

This call returns details of a single Line in a Quote.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Line Item in a Quote

This call updates a single Line in a Quote.
Show Sample PUT data

{
   "rate":100.00,
   "taxable":false
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

description
Description.
  • description - Description
    Example: Sample Description
displayorder
Display Order
  • number - Update Line with display order number 'number'.
    IMPORTANT: This option will NOT reorder any existing lines.
    Example: 1.1
name
Name.
  • name - Name
    Example: Sample name
quantity
Quantity.
  • quantity - Rate
    Example: 5
rate
Rate.
  • rate - Rate
    Example: 500.00
taxable
Taxable status.
  • true - Taxable
  • false - Non-Taxable
time
Time (minutes).
  • time - Rate
    Example: 120

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Mark a Quote as pending

This call will mark a quote as pending (reverts it from an approved or declined state).

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Lines

This call returns a list of Lines from Quotes based on the filters specified. The fields parameter allows you to choose which data fields to return for each Line.
NOTE: The totals will NOT reflect any discount that might be part of the Quote that the line belongs to, if you want to report on Quote Totals then use the 'quotes' call instead.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,type,details,totals
Fields to return.
  • Comma separated list of any of the following:
    • company
    • description
    • details (quantity/rate/time)
    • displayorder
    • name
    • project (project id/title/number)
    • quote (quote id/title/number)
    • quoteddate
    • quotestatus
    • taxable
    • totals (sub/tax/grand totals)
    • type
    Example: name,type

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

approveddatefrom
Lines in Quotes approved on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
approveddateto
Lines in Quotes approved on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
companyid
Company ID or List of Company IDs.
  • companyid/s - Lines in specified Company/ies
    Example: 1,2,3
divisionid
Division ID (Advanced plan only).
  • divisionid - Lines in Quotes in specified Division
    Example: 1
id
List of Quote IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Lines with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Lines with ID greater than or equal to this value .
  • id - ID
    Example: 1
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Lines for specified Project/s
    Example: 1,2
quoteddatefrom
Lines in Quotes created on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
quoteddateto
Lines in Quotes created on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
quotestatus
default: active
Quote Status.
  • pending - Pending Quotes
  • approved - Approved Quotes
  • active - Pending and Approved Quotes
  • declined - Declined Quotes
  • all - All Quotes
searchdescription
Search string.
  • string - Lines where Description contains string
    Example: website
  • !string - Lines where Description does not contain string
    Example: !layout
searchname
Search string.
  • string - Lines where Name contains string
    Example: website
  • !string - Lines where Name does not contain string
    Example: !layout
taxable
default: all
Taxable status.
  • true - Taxable Lines
  • false - Non-Taxable Lines
  • all - All Lines
type
default: all
Line Type.
  • expense - Expense Lines
  • heading - Heading Lines
  • lineitem - Line Item Lines
  • staffrate - Staff Rate Lines
  • taskrate - Task Rate Lines
  • all - All Lines
validtodatefrom
Lines in Quotes valid to/after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
validtodateto
Lines in Quotes valid to/before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Lines.
Example: pagenumber=2&pagesize=10 (return Lines 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - Line ID
  • name - Line Name
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View All Account Settings

This call returns Account settings, including plan details, plugin status, currency, project variable, time and look & feel.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Account License Details

This call returns details of the available, used and total licenses.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Look & Feel Settings

This call returns Look & Feel Settings including logo, title and color scheme.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Account Plan Details

This call returns details of the Plan (solo/professional/advanced) and Plugins status (invoicesplugin/quotesplugin - true/false) for Staff/Clients.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View API Fields

This call returns a list of API Fields.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID.
  • divisionid - API Fields for specified Division
type
default: all
Field Type.
  • all - All
  • company - Company
  • contact - Contact
  • invoice - Invoice
  • project - Project/Project Request
  • quote - Quote
  • task - Task
  • time - Time Record

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add API Field

This call adds an API Field, you must provide a name for the field and the type (the data you want to add this field to). You may optionally set the field to be 'private' so it is only visible to Staff. You cannot have two fields with the same name for the same type.
Show Sample POST data

{
   "name":"New API Field",
   "type":"company"
}

REQUIRED PARAMETERS:

name
Field Name.
  • name - Name
    Example: Sample Name
type
Field Type.
  • company - Company
  • contact - Contact
  • invoice - Invoice
  • project - Project/Project Request
  • quote - Quote
  • task - Task
  • time - Time Record

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

private
default: false
Private Field.
  • false - API Fields visible to all Contacts
  • true - API Fields visible to Staff only

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete API Field

This call deletes an API Field.
NOTE: If you delete an API Field by mistake please contact ProWorkflow's Support team.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View an API Field

This call returns a single API Field.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit API Field

This call updates an API Field.
NOTE: You cannot change the 'type' of an API Field.
Show Sample PUT data

{
   "name":"API Field",
   "private":true
}

REQUIRED PARAMETERS:

name
Field Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

private
default: false
Private Field.
  • false - API Fields visible to all Contacts
  • true - API Fields visible to Staff only

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Divisions

This call returns a list of Divisions including Teams in the Division, the Groups in each Team and Contacts in each Group.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Division

This call deletes a single Division.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Division

This call returns details of a single Division including the Teams in each Division, Groups in each Team and Contacts in each Group.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Division

This call updates a single Division.
Show Sample PUT data

{
   "name":"Europe",
   "code":"EURO"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
city
City.
  • city - City
    Example: Somecity
code
Code.
  • code - Code
    Example: EURO
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
name
Name.
  • name - Name
    Example: Europe
phone
Phone number.
  • phone - Phone number
    Example: 0123 456 7890
state
State.
  • state - State
    Example: Somewhere
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Groups

This call returns a list of Groups including Contacts in each Group.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Groups in specified Division
    Example: 1
teamid
Team ID (Advanced plan only).
  • teamid - Groups in specified Team
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Group

This call adds a Group.
Show Sample POST data

{
   "teamid":1,
   "name":"Europe"
}

REQUIRED PARAMETERS:

name
Name.
  • name - Name
    Example: Europe
teamid
Team ID.
  • teamid - Team ID
    Example: 1

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Group

This call deletes a single Group.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Group

This call returns details of a single Group including the Contacts in the Group.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Group

This call updates a single Group.
Show Sample PUT data

{
   "name":"Europe"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

name
Name.
  • name - Name
    Example: Europe
teamid
Team ID.
  • teamid - Team ID
    Example: 1

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Permissions List

This call returns a list of available Permissions in ProWorkflow.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Roles

This call returns a list of Roles including the Permissions for each Role.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Roles in specified Division
    Example: 1
teamid
Team ID (Advanced plan only).
  • teamid - Roles in specified Team
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Role

This call returns details of a single Role including the Permissions for that Role.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Contact/Company Tags

This call returns a list of Contact/Company Tags.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Tags in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Contact/Company Tag

This call adds a Contact/Company Tag
Show Sample POST data

{
   "name":"New Tag"
}

REQUIRED PARAMETERS:

name
Tag Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
default: A4C0DE
Color.
  • color - HEX Color Code
    Example: FF6600

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Contact Tag

This call deletes a single Contact Tag.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Contact Tag

This call returns details of a single Contact Tag.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Contact Tag

This call updates a single Contact Tag.
Show Sample PUT data

{
   "name":"New Tag"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
Color.
  • color - HEX Color Code
    Example: FF6600
name
Tag Name.
  • name - Name
    Example: Sample Name

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Teams

This call returns a list of Teams including the Groups in each Team and Contacts in each Group.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Teams in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Team

This call adds a Team.
Show Sample POST data

{
   "divisionid":1,
   "name":"Europe",
   "code":"EURO"
}

REQUIRED PARAMETERS:

divisionid
Division ID.
  • divisionid - Division ID
    Example: 1
name
Name.
  • name - Name
    Example: Europe

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
city
City.
  • city - City
    Example: Somecity
code
Code.
  • code - Code
    Example: EURO
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
filespaceemail
Email for Alerts for File Space.
  • email - Email Address
    Example: noreply@proworkflow.com
filespacelimit
File Space Limit (MB).
  • filespacelimit - File Space Limit (MB) (0 - Unlimited)
    Example: 500
phone
Phone number.
  • phone - Phone number
    Example: 0123 456 7890
state
State.
  • state - State
    Example: Somewhere
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Team

This call deletes a single Team.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Team

This call returns details of a single Team including the Groups in the Team and Contacts in each Group.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Team

This call updates a single Team.
Show Sample PUT data

{
   "name":"Europe",
   "code":"EURO"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

address1
Address Line 1.
  • address1 - Address Line 1
    Example: 10 Phantom Road
address2
Address Line 2.
  • address2 - Address Line 2
    Example: Fakeville
address3
Address Line 3.
  • address3 - Address Line 3
    Example: Pretend Town
city
City.
  • city - City
    Example: Somecity
code
Code.
  • code - Code
    Example: EURO
country
Country.
  • country - Country
    Example: Someland
email
Email Address.
  • email - Email Address
    Example: noreply@proworkflow.com
fax
Fax Number.
  • fax - Fax Number
    Example: 0123 456 7890
filespaceemail
Email for Alerts for File Space.
  • email - Email Address
    Example: noreply@proworkflow.com
filespacelimit
File Space Limit (MB).
  • filespacelimit - File Space Limit (MB) (0 - Unlimited)
    Example: 500
name
Name.
  • name - Name
    Example: Europe
phone
Phone number.
  • phone - Phone number
    Example: 0123 456 7890
state
State.
  • state - State
    Example: Somewhere
zipcode
Zipcode.
  • zipcode - Zip or Postal Code
    Example: 90210

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Fixed Cost Items

This call returns a list of Fixed Cost Items.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add Fixed Cost Item/s to a Item Library

This call adds Fixed Cost Item/s to the Item Library.

Show Sample POST data

Single Item:
{
   "name":"Item 1",
   "description":"Item 1 Description",
   "rate":100.00,
   "taxable":true
}

Multiple Items:
[
   {
      "name":"Item 1",
      "rate":100.00,
      "taxable":true
   },
   {
      "name":"Item 2",
      "description":Item 2 Description,
      "rate":100.00,
      "taxable":false
   }
]

REQUIRED PARAMETERS:

name
Name.
  • name - Name
    Example: Sample name
rate
Rate.
  • rate - Rate
    Example: 500.00

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

description
Description.
  • description - Description
    Example: Sample Description
displayorder
default: auto
Display Order
  • auto - Add as last item/s in library.
  • number - Add Line with display order number 'number'.
    IMPORTANT: This option will NOT reorder any existing item/s.
    Example: 12
taxable
default: true
Taxable status.
  • true - Taxable
  • false - Non-Taxable

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Invoices Autonumbering Setting

This call returns the status of Invoices Autonumbering (true/false).

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Invoices Hourly Rates

This call returns a list of Hourly Rate Services.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Invoices Staff Rates

This call returns a list of Staff Rates.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Invoice Templates

This call returns a simple list of Invoice Templates. This call does not return full details or a breakdown of the individual lines for each Invoice Template, you can use the specific Invoice Template call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View an Invoice Template

This call returns details of a single Invoice Template.
IMPORTANT: For Task/Staff Rate Lines, the 'rate' value is cost/hour, the 'time' value is the time in minutes.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Note Categories

This call returns a list of Note Categories.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Note Categories for specified Division

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Note Category

This call adds a single Note Category.
Show Sample POST data

{
   "name":"Sample Name"
}

REQUIRED PARAMETERS:

name
Category Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
default: E7EBEE
Color.
  • color - HEX Color Code
    Example: FF6600

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Note Category

This call deletes a single Note Category.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Note Category

This call returns details of a single Note Category.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Note Category

This call updates a single Note Category.
Show Sample PUT data

{
   "name":"Category Name"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
default: E7EBEE
Color.
  • color - HEX Color Code
    Example: FF6600
name
Category Name.
  • name - Name
    Example: Sample Name

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Default Project Settings

This call returns Default Project settings, these can be changed from the main ProWorkflow application.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Projects Autonumbering Setting

This call returns the status of Projects Autonumbering (true/false).
For Advanced accounts, this call will also return projectsmode (simple/advanced), if the advanced mode is enabled then projectsoptions will be returned containing the available autonumbering options.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1
teamid
Team ID (Advanced plan only).
  • teamid - Settings in specified Team
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Project Categories

This call returns a list of Project Categories.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Project Categories for specified Division

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Project Category/ies

This call adds a Project Category/ies.
Show Sample POST data

Single Category:
{
   "name":"New Category",
"color":"ff6600"
}

Multiple Categories:
[
   {
      "name":"New Category 1"
   },
   {
      "name":"New Category 2"
   }
]

REQUIRED PARAMETERS:

name
Category Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
default: E7EBEE
Color.
  • color - HEX Color Code
    Example: FF6600

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Project Category

This call deletes a single Project Category.
NOTE: A Category can only be deleted via the API if it is not being used by ANY Projects, Requests or Templates (including Completed Projects).

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project Category

This call returns details of a single Project Category.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Project Category

This call updates a single Project Category.
Show Sample PUT data

{
   "name":"New Category"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
Color.
  • color - HEX Color Code
    Example: FF6600
name
Category Name.
  • name - Name
    Example: Sample Name

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Project Custom Fields (Advanced plan only)

This call returns a list of Custom Fields including the Options for each Field.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID.
  • divisionid - Custom Fields for specified Division

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Project Custom Statuses (Advanced plan only)

This call returns a list of Custom Statuses.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID.
  • divisionid - Custom Statuses for specified Division
teamid
Team ID.
  • teamid - Custom Statuses for specified Team

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Project Custom Status (Advanced plan only)

This call adds a Project Custom Status.
Show Sample POST data

Single Status:
{
   "teamid":"1"
   "name":"Planning"
   "color":"FF6600"
}

REQUIRED PARAMETERS:

color
Color.
  • color - HEX Color Code
    Example: FF6600
name
Status Name.
  • name - Status Name
    Example: Sample Name
teamid
Team Id.
  • teamid - Team ID
    Example: 1

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Custom Status (Advanced plan only)

This call deletes a single Custom Status.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project Custom Status (Advanced plan only)

This call returns a single Custom Status.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Custom Status (Advanced plan only)

This call updates a single Custom Status.
Show Sample PUT data

{
   "name":"New Custom Status"
   "color":"FF6600"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
Color.
  • color - HEX Color Code
    Example: FF6600
name
Custom Status Name.
  • name - Name
    Example: Sample Name

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Project Tags

This call returns a list of Project Tags.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Tags in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Project Tag

This call adds a Project Tag
Show Sample POST data

{
   "name":"New Tag"
}

REQUIRED PARAMETERS:

name
Tag Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
default: A4C0DE
Color.
  • color - HEX Color Code
    Example: FF6600

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Project Tag

This call deletes a single Project Tag.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project Tag

This call returns details of a single Project Tag.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Project Tag

This call updates a single Project Tag.
Show Sample PUT data

{
   "name":"New Tag"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
Color.
  • color - HEX Color Code
    Example: FF6600
name
Tag Name.
  • name - Name
    Example: Sample Name

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Project Templates (Advanced plan only)

This call returns a list of Project Templates, for Staff contacts this will include 'externalclient', 'internalclient' and 'internalstaff' which specify respectively whether the request can be used by external/internal clients making a request and by staff creating a new Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project Template

This call returns details of a single Project Template.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Default Quote Settings

This call returns Default Quote settings, these can be changed from the main ProWorkflow application.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Quotes Autonumbering Setting

This call returns the status of Quotes Autonumbering (true/false).

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Quotes Hourly Rates

This call returns a list of Hourly Rate Services.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Quotes Staff Rates

This call returns a list of Staff Rates.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Quotes Templates

This call returns a simple list of Quote Templates. This call does not return full details or a breakdown of the individual lines for each Quote Template, you can use the specific Quote Template call to return that information.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Quote Template

This call returns details of a single Quote Template.
IMPORTANT: For Task/Staff Rate Lines, the 'rate' value is cost/hour, the 'time' value is the time in minutes.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Service Rates

This call returns a list of Service Rates.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Staff Rates

This call returns a list of Staff Rates.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Settings in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Task Categories

This call returns a list of Task Categories (available for General Tasks only).

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Task Categories for specified Division

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Task Category

This call adds a Task Category.
Show Sample POST data

{
   "name":"New Category"
}

REQUIRED PARAMETERS:

name
Category Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
default: E7EBEE
Color.
  • color - HEX Color Code
    Example: FF6600

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Task Category

This call deletes a single Task Category.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Task Category

This call returns details of a single Task Category.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Task Category

This call updates a single Task Category.
Show Sample PUT data

{
   "name":"Sample Name"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
Color.
  • color - HEX Color Code
    Example: FF6600
name
Category Name.
  • name - Name
    Example: Sample Name

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Task Tags

This call returns a list of Task Tags.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Tags in specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Task Tag

This call adds a Task Tag
Show Sample POST data

{
   "name":"New Tag"
}

REQUIRED PARAMETERS:

name
Tag Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
default: A4C0DE
Color.
  • color - HEX Color Code
    Example: FF6600

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Task Tag

This call deletes a single Task Tag.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Task Tag

This call returns details of a single Task Tag.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Task Tag

This call updates a single Task Tag.
Show Sample PUT data

{
   "name":"New Tag"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

color
Color.
  • color - HEX Color Code
    Example: FF6600
name
Tag Name.
  • name - Name
    Example: Sample Name

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Task Templates

This call returns a list of Task Templates

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID (Advanced plan only).
  • divisionid - Task Templates for specified Division

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Task Template

This call adds a Task Template, to add Tasks to a Template use the 'settings/tasks/template/templateid/tasks' call.
Show Sample POST data

{
   "name":"New Template",
   "smartordering":"true"
}

REQUIRED PARAMETERS:

excludeweekends
default: false
Exclude Weekends when calculating Start and Due Dates.
  • true - Exclude Weekends
  • false - Include Weekends
name
Template Name.
  • name - Name
    Example: Sample Name
smartordering
default: true
Enable Smart Ordering.
  • true - Enable Smart Ordering
  • false - Disable Smart Ordering

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Task Template

This call deletes a single Task Template.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Task Template

This call returns a single Task Template

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Task Template

This call updates a Task Template.
Show Sample PUT data

{
   "name":"New Name",
   "excludeweekends":"true"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

excludeweekends
Exclude Weekends when calculating Start and Due Dates.
  • true - Exclude Weekends
  • false - Include Weekends
name
Template Name.
  • name - Name
    Example: Sample Name
smartordering
Enable Smart Ordering.
  • true - Enable Smart Ordering
  • false - Disable Smart Ordering

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Tasks in a Task Template

This call returns Tasks in a single Task Template

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add a Task/s to a Task Template

This call adds a Task/s to a Task Template.
If 'order' is not specified then the Task/s will be added as the last Task/s on the Template. Please refer to the 'order' parameter for further details on available options.
If Smart Ordering is enabled for the Template then you can use the 'order' setting to choose where to insert the Template.
IMPORTANT: When adding multiple Tasks they must have the same 'order' option or have a specific order number. When multiple Tasks are added using 'auto/after/before' for the 'order' options then they are added to the Template in the order they are provided in your data.
Show Sample POST data

Single Task:
{
   "name":"Adam",
   "contacts":"1,2",
   "startday":"1"
}

Multiple Tasks:
[
   {
      "name":"Adam",
      "priority":2,
      "contacts":"me",
      "startday":"1"
   },
   {
      "name":"Bob",
      "contacts":"1,2,3",
      "startday":"4"
   },
   {
      "name":"Charles",
      "contacts":"1,2,3",
      "startday":"10"
   }
]

REQUIRED PARAMETERS:

contacts
default: none
Assigned Contacts.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • none - No Contacts (we recommend not using this option unless essential)
name
Name.
  • name - Name
    Example: Sample Name
servicename
Service Name.
  • servicename - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

billable
default: true
Billable (true/false to set whether Task is billable).
  • true - Billable
  • false - Not billable
description
Description.
  • description - Description
    Example: Sample Description
dueday
Due Day.
  • none - No Due Day
  • Relative date - Day 1 is the Start Date applied to Template
    Examples: 5 - Day 5
order
default: auto
Order
  • auto - Add as last Task in Template (set 'orderlevel' to add as a sub task or sub sub task). If no Tasks exist or adding a general task then the order number will be 1/1.1/1.1.1 depending on 'orderlevel'.
  • aftertaskid - Add after 'taskid' in Template (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically.
    IMPORTANT: Only available when Smart Ordering is enabled for the Template.
    Example: after1
  • beforetaskid - Add before 'taskid' in Template (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically.
    IMPORTANT: Only available when Smart Ordering is enabled for the Template.
    Example: before1
  • ordernumber - Add Task with order number 'ordernumber', if adding to a Template and compulsory task ordering is enabled then you must specify an order number not already in use in the Template.
    IMPORTANT: This option will NOT reorder any existing tasks.
    Example: 1.1
orderlevel
default: normal
Order Level (used when 'order' is set to 'auto', 'aftertaskid' or 'beforetaskid')
  • normal - normal (top level) task
  • sub - sub task
  • subsub - sub sub task
prerequisites
Prerequisite Tasks (this clears any previous dependencies)
  • taskid/s - Task ID or List of Task IDs in the same Template as this Task or reference new Tasks added at the same time as this task using newX for the Xth new task.
    Example: 1,2,new2
  • none - Remove existing prerequisites
priority
default: 3
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
servicedescription
Service Description.
  • servicedescription - Description
    Example: Sample Description
servicerate
Service Rate (Cost per hour).
  • servicerate - Rate
    Example: 150.00
startday
Start Day.
  • none - No Start Day
  • Relative date - Day 1 is the Start Date applied to Template
    Examples: 5 - Day 5
taxable
default: true
Taxable (true/false to set whether Task is taxable).
  • true - Taxable
  • false - Not taxable
timeallocated
default: 0
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300
type
default: normal
Type')
  • normal - normal task
  • bold - bold task
  • heading - heading task

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Task in a Task Template

This call deletes a Task in a Task Template, this will also delete all Files for the Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Task in a Task Template

This call returns details of a single Task in a Task Template.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Task in a Task Template

This call updates a Task in a Task Template.
Show Sample PUT data

{
   "name":"Sample Task",
   "description":"Sample Task Description",
   "priority":2,
   "startday":"1",
   "dueday":"2"
}

REQUIRED PARAMETERS:

contacts
Assigned Contacts.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • none - No Contacts (we recommend not using this option unless essential)
name
Name.
  • name - Name
    Example: Sample Name
servicename
Service Name.
  • servicename - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

billable
Billable (true/false to set whether Task is billable).
  • true - Billable
  • false - Not billable
description
Description.
  • description - Description
    Example: Sample Description
dueday
Due Day.
  • none - No Due Day
  • Relative date - Day 1 is the Start Date applied to Template
    Examples: 5 - Day 5
order
Order
  • auto - Add as last Task in Template (set 'orderlevel' to add as a sub task or sub sub task). If no Tasks exist or adding a general task then the order number will be 1/1.1/1.1.1 depending on 'orderlevel'.
  • aftertaskid - Add after 'taskid' in Template (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically.
    IMPORTANT: Only available when Smart Ordering is enabled for the Template.
    Example: after1
  • beforetaskid - Add before 'taskid' in Template (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically.
    IMPORTANT: Only available when Smart Ordering is enabled for the Template.
    Example: before1
  • ordernumber - Add Task with order number 'ordernumber', if adding to a Template and compulsory task ordering is enabled then you must specify an order number not already in use in the Template.
    IMPORTANT: This option will NOT reorder any existing tasks.
    Example: 1.1
orderlevel
Order Level (used when 'order' is set to 'auto', 'aftertaskid' or 'beforetaskid')
  • normal - normal (top level) task
  • sub - sub task
  • subsub - sub sub task
prerequisites
Prerequisite Tasks (this clears any previous dependencies)
  • taskid/s - Task ID or List of Task IDs in the same Project as this Task.
    Example: 1,2
  • none - Remove existing prerequisites
priority
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
servicedescription
Service Description.
  • servicedescription - Description
    Example: Sample Description
servicerate
Service Rate (Cost per hour).
  • servicerate - Rate
    Example: 150.00
startday
Start Day.
  • none - No Start Day
  • Relative date - Day 1 is the Start Date applied to Template
    Examples: 5 - Day 5
taxable
Taxable (true/false to set whether Task is taxable).
  • true - Taxable
  • false - Not taxable
timeallocated
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300
type
Type')
  • normal - normal task
  • bold - bold task
  • heading - heading task

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Web Hooks

This call returns a list of Active Web Hooks.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID.
  • divisionid - Hooks for specified Division
event
default: all
Event Type.
  • all - All
  • company - Company
  • contact - Contact
  • file - File
  • invoice - Invoice
  • message - Message
  • project - Project
  • projectrequest - Project Request
  • quote - Quote
  • sharednote - Shared Note
  • task - Task
  • time - Time Record
  • timer - Timers

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add Web Hook

This call adds a Web Hook, you must provide an event to trigger from and a URL that will receive a POST request when the event occurs. The POST request will contain the ID of the added/updated object and a url to use in a GET request to return the details of the object unless the object was deleted.
IMPORTANT: Some actions will fire multiple events (e.g. stopping a timer will fire stoptimer and newtime) so take care when subscribing to both events to ensure you only act on them once.
Show Sample POST data

{
   "event":"addproject",
   "url":"https://yourapi.net/webhook"
}

REQUIRED PARAMETERS:

event
Event (the action that will trigger the hook).
  • newcontact - New Contact
  • newpendingcontact - New Pending Contact
  • editcontact - Edit Contact
  • editcontactlocation - Edit Contact Location (POST data contains ID of Contact that updated their Location)
  • deletecontact - Delete Contact
  • newcompany - New Company
  • newpendingcompany - New Pending Company
  • editcompany - Edit Company
  • deletecompany - Delete Company
  • newfile - New File
  • deletefile - Delete File
  • newinvoice - New Invoice
  • editinvoice - Edit Invoice
  • deleteinvoice - Delete Invoice
  • newmessage - New Message
  • editmessage - Edit Message
  • deletemessage - Delete Message
  • newproject - New Project
  • editproject - Edit Project
  • deleteproject - Delete Project
  • completeproject - Complete Project
  • reactivateproject - Reactivate Project
  • newprojectrequest - New Project Request
  • editprojectrequest - Edit Project Request
  • deleteprojectrequest - Delete Project Request
  • approveprojectrequest - Approve Project Request
  • declineprojectrequest - Declined Project Request
  • newquote - New Quote
  • editquote - Edit Quote
  • deletequote - Delete Quote
  • newsharednote - New Shared Note
  • editsharednote - Edit Shared Note
  • deletesharednote - Delete Shared Note
  • newtask - New Task
  • edittask - Edit Task
  • deletetask - Delete Task
  • completetask - Complete Task
  • reactivatetask - Reactivate Task
  • newtime - New Time Record
  • edittime - Edit Time Record
  • deletetime - Delete Time Record
  • starttimer - Start a Timer
  • stoptimer - Stop a Timer
url
URL.
  • url - URL
    Example: https://yourapi.net/webhook

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Web Hook

This call deletes a Web Hook

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Web Hook

This call returns a single Web Hook.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Web Hook

This call updates a Web Hook.
NOTE: You cannot change the 'event' of a Web Hook, if you need to do so then you can delete the existing Hook and create a new one.
Show Sample PUT data

{
   "url":"https://yourapi.net/resthook",
}

REQUIRED PARAMETERS:

url
URL.
  • url - URL
    Example: https://yourapi.net/resthook

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Web Hook Requests

This call returns a list of Web Hook Requests for debugging purposes. Requests older than 7 days are automatically deleted.
For each request, this call returns:

  • completetime (the time this request completed successfully)
  • dataid (ID of the object that triggered the request)
  • dataurl (GET URL for the object that triggered the request unless this was deleted)
  • event (the event that triggered the request)
  • httpstatuscode (the most recent HTTP status code for the request)
  • nextruntime (the time when this request will try next)
  • requestid
  • resthookid (rest hook that triggered the request)
  • starttime (the time this request ran successfully)
  • tries (the number of attempts made to send this request)
  • url (the URL the request is being sent to)
IMPORTANT: A failed request will try again once after 1 minute, then 4 more times at 15 minute intervals, then 4 more times at hourly intervals before it is deemed to have failed and the request and parent rest hook subscription are deleted.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

divisionid
Division ID.
  • divisionid - Hooks for specified Division
event
default: all
Event Type.
  • all - All
  • company - Company
  • contact - Contact
  • file - File
  • invoice - Invoice
  • message - Message
  • project - Project
  • projectrequest - Project Request
  • quote - Quote
  • sharednote - Shared Note
  • task - Task
  • time - Time Record
  • timer - Timers
resthookid
Web Hook ID or List of Web Hook IDs.
  • resthookid/s - Requests for one of the specified Web Hook ID/s
    Example: 1,2,3
status
default: pending
Status.
  • pending - Pending Requests
  • complete - Completed Requests
  • all - All Requests

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Shared Notes

This call returns a list of Shared Notes based on the filters specified. The fields parameter allows you to choose which data fields to return for each Shared Note.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: content,title
Fields to return.
  • Comma separated list of any of the following:
    • company
    • content
    • project(includes id/number/title)
    • title
    Example: content,title

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

categoryid
Project Category ID or List of Project Category IDs.
  • categoryid/s - Notes for Projects in specified Category/ies
    Example: 1,2
companyid
Company ID or List of Company IDs.
  • companyid/s - Notes for specified Company/ies
    Example: 1,2,3
divisionid
Division ID (Advanced plan only).
  • divisionid - Notes in specified Division
    Example: 1
id
List of Note IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Notes with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Notes with ID greater than or equal to this value .
  • id - ID
    Example: 1
projectid
Project ID or List of Project IDs.
  • projectid/s - Project ID or List of Project IDs - Notes for specified Project/s
    Example: 1,2
projectstatus
default: active
Project Completion Status.
  • active - Notes for Active Projects
  • complete - Notes for Completed Projects
  • all - Notes for All Projects
search
Search string.
  • string - Notes where Title contains string
    Example: website
  • !string - Notes where Title does not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Notes.
Example: pagenumber=2&pagesize=10 (return Notes 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - Note ID
  • projectid - Project ID
  • title - Note Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Shared Note

This call adds a single Shared Note.
Show Sample POST data

{
   "projectid":1,
   "title":"New Shared Note",
   "content":"Note Description"
}

REQUIRED PARAMETERS:

projectid
Project ID.
  • projectid - Project ID
title
Title.
  • title - Title
    Example: Sample Title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

content
Content.
  • content - Content
    Example: Sample Description

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Project Shared Note

This call deletes a single Project Shared Note.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Project Shared Note

This call returns details of a single Project Shared Note.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Project Shared Note

This call updates a single Project Shared Note.
Show Sample PUT data

{
   "title":"Sample Title"
   "content":"Sample Content"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

content
Content.
  • content - Content
    Example: Sample Content
title
Title.
  • title - Title
    Example: Sample Title

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

DELETE PUT POST GET

Staff
Client
Contractor
View Tasks

This call returns a list of Tasks based on the filters specified. The fields parameter allows you to choose which data fields to return for each Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,type,order,status,project,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • billable
    • burn (returns budget/burn/totalburn where burn reflects the burn based on any time-based filters)
    • category
    • company
    • completedate
    • contacts
    • creator
    • (contact who added this Task)
    • dates (returns start/due/complete)
    • dependent (returns currenttask status and prerequisites)
    • description
    • duedate
    • lastmodified
    • name
    • order
    • priority
    • project
    • (returns ID/Number/Title)
    • projectid
    • projectcategory
    • (returns ID/Name)
    • projectcustomstatus
    • (returns ID/Name/Color - ADV Plan Only)
    • projectmanager
    • (returns ID/Name)
    • projectstatus
    • service (returns servicedescription/servicename/servicerate)
    • status
    • tags
    • tasklist
    • taxable
    • timeallocated
    • timetracked
    • type
    Example: order,name,project

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Tasks where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Tasks where ANY of the specified apifields match
  • all - Tasks where ALL of the specified apifields match
billable
default: all
Billable status.
  • true - Billable Tasks
  • false - Non-Billable Tasks
  • all - All Tasks
categoryid
Category.
  • categoryid/s - General Tasks in specified Category/ies
    Example: 1,2
  • !categoryid/s - General Tasks NOT in specified Category/ies
    Example: !1,2
companyid
Company.
  • companyid/s - Company ID or List of Company IDs - Tasks in Projects for specified Company/ies
    Example: 1,2
completedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Tasks assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • me - Tasks assigned to Contact making request
  • unassigned - Unassigned Tasks
  • all - All Tasks
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Tasks assigned to ANY of the specified contacts
  • all - Tasks assigned to ALL of the specified contacts
dependentstatus
default: all
Task Dependent Status
  • current - Current Tasks
  • noncurrent - Non-Current Tasks
  • all - All Tasks
divisionid
Division ID (Advanced plan only).
  • divisionid - Tasks in specified Division
    Example: 1
duedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
generaltasks
default: true
General Tasks.
  • true - Include General Tasks
  • false - Exclude General Tasks
id
List of Task IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Tasks with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Tasks with ID greater than or equal to this value .
  • id - ID
    Example: 1
internalclientgroupid
Group ID or List of Group IDs.
  • groupid/s - Tasks for specified Group/s
    Example: 1,2,3
internalclientteamid
Team ID or List of Team IDs.
  • companyid/s - Tasks for specified Team/s
    Example: 1,2,3
lastmodifiedfrom
Tasks added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Tasks added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Tasks added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Tasks added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Tasks in Projects managed by specified Contact/s
    Example: 1,2
  • me - Tasks in Projects managed by Contact making request
priority
Priority (1-5 representing Very High-Very Low).
  • priority/ies - Tasks with specified Priority/ies
    Example: 1,2
  • !priority/ies - Tasks NOT with specified Priority/ies
    Example: !4,5
projectcategoryid
Project Category ID or List of Project Category IDs.
  • projectcategoryid/s - Tasks in Projects in specified Category/ies
    Example: 1,2,3
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcustomfieldoptionid
Custom Field Option ID/s (Advanced plan only)
  • customfieldoptionid/s - Tasks in Projects with specified Custom Field Option/s (applies only to custom fields of dropdown type)
    Example: 1,2
projectcustomfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Tasks in Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
projectcustomfieldsmode
default: any
Mode used for the customfields or customfieldoptionid parameter.
  • any - Tasks in Projects where ANY of the specified customfields match
  • all - Tasks in Projects where ALL of the specified customfields match
  • none - Tasks in Projects where NONE of the specified customfields match
projectcustomstatusid
Custom Status ID or List of Custom Status IDs (Advanced plan only).
  • projectcustomstatusid/s - Tasks in Projects with specified Custom Status/es
    Example: 1,2
  • !projectcustomstatusid/s - Tasks in Projects without specified Custom Status/es
    Example: !1,2
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project.
  • projectid/s - Tasks in specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstatus
default: all
Project Status.
  • active - Tasks in Active Projects
  • complete - Tasks in Completed Projects
  • all - Tasks in All Projects
projecttasks
default: true
Project Tasks.
  • true - Include Project Tasks
  • false - Exclude Project Tasks
projectteamid
Team ID(Advanced plan only).
  • projectteamid/s - Team ID or List of Team IDs - Tasks in Projects Managed by any of the specified Team/s
    Example: 1,2
  • !projectteamid/s - Team ID or List of Team IDs - Tasks in Projects NOT Managed by any of the specified Team/s
    Example: !1,2
searchdescription
Search Description.
  • string - Tasks where Description contains string
    Example: website
  • !string - Tasks where Description does not contain string
    Example: !layout
searchname
Search Name.
  • string - Tasks where Name contains string
    Example: website
  • !string - Tasks where Name does not contain string
    Example: !layout
startdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Task Status.
  • active - Active Tasks
  • complete - Completed Tasks
  • all - All Tasks
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Projects with specified Tag/s
    Example: 1,2,3
  • !tagid/s - Projects without specified Tag/s
    Example: !1,2,3
taxable
default: all
Taxable status.
  • true - Taxable Tasks
  • false - Non-Taxable Tasks
  • all - All Tasks
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timetracked
Tasks where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto parameters apply to the starred options.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
type
default: all
Task Type.
  • normal - Normal Tasks
  • bold - Bold Tasks
  • heading - Heading Tasks
  • nonheading - Non-Heading Tasks (Normal + Bold)
  • all - All Tasks
upcomingdatefrom
Tasks with a start OR due date on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
upcomingdateto
Tasks with a start OR due date on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Tasks.
Example: pagenumber=2&pagesize=10 (return Tasks 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - ID
  • order - Order
  • name - Name
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • priority - Priority
  • projectid - Project ID
  • projectnumber - Project Number
  • projecttitle - Project Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Task/s

This call adds a Task/s, you must provide either 'projectid' (to add a Task/s to a Project) or 'categoryid' (to add a General Task/s).
You must either provide details for one or more Tasks OR specify a Task Template ID.
If 'order' is not specified then the Task/s will be added as the last Task/s on the Project. Please refer to the 'order' parameter for further details on available options.
When specifying a Task Template ID that includes relative dates you can specify 'startdate' to set the date corresponding to day 1 in the Template OR specify 'duedate' to set the date corresponding to the latest day in the Template.
If Smart Ordering is enabled for the Project then you can use the 'order' setting to choose where to insert the Template.
When using a Template you can set the 'addtemplatecontacts' option to choose whether Contacts in the Template who are not assigned to the Project should be added to the Project or removed from the Tasks.
IMPORTANT: When adding multiple Tasks they must all have the same 'categoryid' or 'projectid'. Each Task must also have the same 'order' option or have a specific order number. When multiple Tasks are added using 'auto/after/before' for the 'order' options then they are added to the project in the order they are provided in your data.
Show Sample POST data

Single Task:
{
   "name":"Adam",
   "projectid":1,
   "contacts":"1,2",
   "startdate":"2014-01-18"
}

Multiple Tasks:
[
   {
      "name":"Adam",
      "projectid":1,
      "priority":2,
      "contacts":"me",
      "startdate":"2014-01-18"
   },
   {
      "name":"Bob",
      "projectid":1,
      "contacts":"allstaff",
      "startdate":"2014-01-23"
   },
   {
      "name":"Charles",
      "projectid":1,
      "contacts":"1,2,3",
      "startdate":"2014-01-28"
   }
]

Task Template:
{
   "templateid":1,
   "projectid":1,
   "startdate":"2014-01-18"
}

REQUIRED PARAMETERS:

categoryid
Category ID.
  • categoryid - Category ID
    Example: 1
contacts
default: me
Assigned Contacts.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Contacts assigned to Project (Project Tasks) or All Staff (General Tasks)
  • allstaff - All Staff assigned to Project (Project Tasks) or All Staff (General Tasks)
  • none - No Contacts (we recommend not using this option unless essential)
name
Name.
  • name - Name
    Example: Sample Name
projectid
Project ID.
  • projectid - Project ID
    Example: 1
servicename
Service Name.
  • servicename - Name
    Example: Sample Name
templateid
Task Template ID.
  • templateid - Task Template ID
    Example: 1

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

addtemplatecontacts
default: true
Assign Template Contacts to Project
  • true - Contacts in the Template will be assigned to the Project
  • false - Contacts not assigned to the Project will be ignored in the Template
apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
billable
default: true
Billable (true/false to set whether Task is billable).
  • true - Billable
  • false - Not billable
completedate
Complete Date, if specified then the Task will be added with a Completed status (alerts are not sent when adding Completed Tasks).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
description
Description.
  • description - Description
    Example: Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
order
default: auto
Order
  • auto - Add as last Task in Project (set 'orderlevel' to add as a sub task or sub sub task). If no Tasks exist or adding a general task then the order number will be 1/1.1/1.1.1 depending on 'orderlevel'.
  • aftertaskid - Add after 'taskid' in Project (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically. Only available when adding Tasks to a Project.
    IMPORTANT: Only available when Smart Ordering is enabled for the Project.
    Example: after1
  • beforetaskid - Add before 'taskid' in Project (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically. Only available when adding Tasks to a Project.
    IMPORTANT: Only available when Smart Ordering is enabled for the Project.
    Example: before1
  • ordernumber - Add Task with order number 'ordernumber', if adding to a Project and compulsory task ordering is enabled then you must specify an order number not already in use in the Project.
    IMPORTANT: This option will NOT reorder any existing tasks.
    Example: 1.1
orderlevel
default: normal
Order Level (used when 'order' is set to 'auto', 'aftertaskid' or 'beforetaskid')
  • normal - normal (top level) task
  • sub - sub task
  • subsub - sub sub task
prerequisites
Prerequisite Tasks (this clears any previous dependencies)
  • taskid/s - Task ID or List of Task IDs in the same Project as this Task or reference new Tasks added at the same time as this task using newX for the Xth new task.
    Example: 1,2,new2
  • none - Remove existing prerequisites
priority
default: 3
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
servicedescription
Service Description.
  • servicedescription - Description
    Example: Sample Description
servicerate
Service Rate (Cost per hour).
  • servicerate - Rate
    Example: 150.00
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
tasklistid
Task List ID.
  • tasklistid - Task List ID
    Example: 1
taxable
default: true
Taxable (true/false to set whether Task is taxable).
  • true - Taxable
  • false - Not taxable
timeallocated
default: 0
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300
type
default: normal
Type')
  • normal - normal task
  • bold - bold task
  • heading - heading task

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Task

This call deletes a Task, this will also delete all Files, Messages & Time Records for the Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Task

This call returns details of a single Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

contactdetails
default: false
Contact Details.
  • true - Return email, image, phone for contacts
  • false - Do not return email, image, phone for contacts
files
default: true
Files.
  • true - Include Files
  • false - Do Not Include Files
messages
default: true
Messages.
  • true - Include Messages
  • false - Do Not Include Messages
messagescontacts
default: me
Messages Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Include Messages to/from specified Contact/s
    Example: 1,2
  • me - Include Messages to/from Contact making request
  • all - Include Messages for All Contacts
timerecords
default: false
Time Records.
  • true - Include Individual Time Records
  • false - Do Not Include Individual Time Records

FILTER PARAMETERS:

timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Task

This call updates a Task.
IMPORTANT - This call is NOT used to complete or reactivate a Task, use the specific complete and reactivate calls instead.
Show Sample PUT data

{
   "name":"Sample Task",
   "description":"Sample Task Description",
   "priority":2,
   "startdate":"2014-04-18",
   "duedate":"2014-04-28"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
billable
Billable (true/false to set whether Task is billable).
  • true - Billable
  • false - Not billable
categoryid
Category ID (General Tasks only).
  • categoryid - Category ID
    Example: 1
completedate
Completed Date (only available for completed tasks).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
Assigned Contacts.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Contacts assigned to Project (Project Tasks) or All Staff (General Tasks)
  • allstaff - All Staff assigned to Project (Project Tasks) or All Staff (General Tasks)
  • none - No Contacts (we recommend not using this option)
description
Description.
  • description - Description
    Example: Sample Description
  • +=description - Append to Existing Description
    Example: +=Sample Description
duedate
Due Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
name
Name.
  • name - Name
    Example: Sample Name
order
Order
  • aftertaskid - Add after 'taskid' in Project (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically. Only available when adding Tasks to a Project.
    IMPORTANT: Only available when Smart Ordering is enabled for the Project.
    Example: after1
  • beforetaskid - Add before 'taskid' in Project (set 'orderlevel' to add as a sub task or sub sub task). Any existing Tasks will be reordered automatically. Only available when adding Tasks to a Project.
    IMPORTANT: Only available when Smart Ordering is enabled for the Project.
    Example: before1
  • ordernumber - Add Task with order number 'ordernumber', if adding to a Project and compulsory task ordering is enabled then you must specify an order number not already in use in the Project.
    IMPORTANT: This option will NOT reorder any existing tasks.
    Example: 1.1
orderlevel
Order Level - available when 'order' is not specified or when it is set to 'aftertaskid' or 'beforetaskid. If 'order' is not specified then this will change the level of a task without moving its relative position in the Project'.
IMPORTANT: Only available when Smart Ordering is enabled for the Project.
  • normal - normal (top level) task
  • sub - sub task
  • subsub - sub sub task
prerequisites
Prerequisite Tasks (this clears any previous dependencies)
  • taskid/s - Task ID or List of Task IDs in the same Project as this Task.
    Example: 1,2
  • none - Remove existing prerequisites
priority
Priority (1-5 representing Very High-Very Low).
  • priority - Priority
    Example: 1
servicedescription
Service Description.
  • servicedescription - Description
    Example: Sample Description
servicename
Service Name.
  • servicename - Name
    Example: Sample Name
servicerate
Service Rate (Cost per hour).
  • servicerate - Rate
    Example: 150.00
startdate
Start Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
tagid
Tag ID or List of Tag IDs.
  • tagid - Tag ID/s
    Example: 1,2,3
tasklistid
Task List ID.
  • tasklistid - Task List ID
    Example: 1
taxable
Taxable (true/false to set whether Task is taxable).
  • true - Taxable
  • false - Not taxable
timeallocated
Time Allocated.
  • number - Time Allocated (minutes)
    Example: 300
type
Type')
  • normal - normal task
  • bold - bold task
  • heading - heading task

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Adjust date/s for a Task

This call adjusts the dates for a single Task, by default this will adjust the start AND due dates of the Task, you can use the 'dates' option to adjust just the start or due date. Set the 'adjustment' option to set the number of calendar days/weeks/months/years to adjust the Task by.
IMPORTANT: A positive value defers a Task, a negative value advances a Task.
Use this call with care as running it multiple times by mistake will adjust dates multiple times.
Show Sample PUT data

{
   "adjustment":"+1w",
   "dates":"all"
}

REQUIRED PARAMETERS:

adjustment
Adjustment.
  • +/-Xd/w/m/y - +/-Xd/w/m/y (Example: -3w - advance dates by 3 weeks, +1m - defer dates by 1 month)
dates
default: all
Dates to update.
  • all - Start and Due Date
  • due - Due Date
  • start - Start Date

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Complete a Task

This call completes a single Task. You can specify 'completedate' otherwise the current user's time is used.
Show Sample PUT data

{
   "completedate":"2014-04-28"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

completedate
Complete Date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View contacts assigned to a Task

This call returns details of the Contacts assigned to a Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Add/Remove Contacts to a Task

This call adds or removes Contacts to/from a single Task (use the 'remove' option to REMOVE Contacts, default is to ADD Contacts.
IMPORTANT: For Project Tasks you can only assign Contacts already assigned to the Project. For General Tasks you can only assign Staff.
Show Sample PUT data

{
   "contacts":"1,2",
   "remove":true
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

contacts
Contacts to Add/Remove.
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
remove
default: false
Set whether to remove Contacts.
  • true - Remove Contacts from Project
  • false - Add Contacts to Project

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Files for a Task

This call returns details of Files for a Task based on the specified filters. The fields parameter allows you to choose which data fields to return for each File.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,date,size,link
Fields to return.
  • Comma separated list of any of the following:
    • contacts (returns 'all' if File is public, returns array of contacts if File is private)
    • date
    • folder (includes id,name)
    • link
    • name
    • project (includes id/number/title)
    • size
    • task (includes id/name)
    Example: name,size,link

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

datefrom
Files added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Files added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
search
Search string.
  • string - Files where Name contains string
    Example: website
  • !string - Files where Name does not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Files.
Example: pagenumber=2&pagesize=10 (return Files 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: name
Sort field.
  • id - File ID
  • name - File Name
  • size - File Size
  • date - File Date
  • folderid - Folder ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a File to a Task

This call adds a single File to a Task. To add a File to a Custom Folder, use the '/files' call with the 'folderid' option.
Show Sample POST data

{
   "name":"filename.txt",
   "content":"U29tZSB0ZXh0"
}

REQUIRED PARAMETERS:

content
Base64-encoded content.
  • content
name
Name.
  • name - Name
    Example: Sample Name

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Messages for a Task

This call returns details of Messages for a Task. The fields parameter allows you to choose which data fields to return for each Message.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: title,content,originalmessageid,date,author,contacts,public,files
Fields to return.
  • Comma separated list of any of the following:
    • author
    • contacts
    • content
    • date
    • files (returns list of any attached files)
    • originalmessageid (returns id of the message that started the discussion that this message replies to, returns blank string if this message started a new discussion)
    • project (includes id/number/title)
    • projectid
    • projectnumber
    • projecttitle
    • public (returns 'true' if message is public)
    • task (includes id/name)
    • taskid
    • taskname
    • title
    Example: author,title,content

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Messages to/from specified Contact/s
    Example: 1,2
  • me - Messages to/from Contact making request
  • all - Messages for All Contacts
datefrom
Messages added on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
dateto
Messages added on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
divisionid
Division ID (Advanced plan only).
  • divisionid - Messages in specified Division
    Example: 1
originalmessageid
Original Message ID.
  • originalmessageid - Messages in the discussion started by originalmessageid
    Example: 1
search
Search string.
  • string - Messages where Title contains string
    Example: website
  • !string - Messages where Title does not contain string
    Example: !layout

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Messages.
Example: pagenumber=2&pagesize=10 (return Messages 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - Message ID
  • originalmessageid - Original Message ID
  • date - Message Date
  • projectid - Project ID
  • taskid - Task ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Message to a Task

This call starts a new discussion in a Task. To attach files, they must first be uploaded and can then be attached to a message using the fileid parameter. To reply to an existing discussion, use the '/messsages' call with the 'originalmessageid' option.
Show Sample POST data

{
   "contacts":"1,2",
   "title":"New Message",
   "content":"Message Content",
   "fileid":"15"
}

REQUIRED PARAMETERS:

contacts
Contacts (required when starting a new discussion).
  • contactid/s - Contact ID or List of Contact IDs
    Example: 1,2
  • me - Contact making request
  • all - All Contacts Assigned to Project
content
Content.
  • content - Content
    Example: Sample content
title
Title (Required when starting a new discussion).
  • title - Title
    Example: Sample title

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

files
Files to attach to the Message (Files must belong to the same Project as the Message).
  • fileid/s - File ID or List of File IDs
    Example: 1,2
notifications
default: true
Notifications (Available when starting a new discussion).
  • true - Enable Email Notifications
  • false - Disable Email Notifications
public
default: true
Public Discussion.
  • true - Make Discussion Public
  • false - Make Discussion Private

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Reactivate a Task

This call reactivates a single Task.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Start a Timer for a Task

This call starts a timer for a Task. If another timer is already running then it will be stopped.
Show Sample PUT data

{
   "notes":"Sample notes"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

notes
Notes.
  • notes - Notes
    Example: Sample notes

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Stop a Timer for a Task

This call stops a timer for a Task.
Show Sample PUT data

{
   "notes":"Sample notes"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

notes
Notes.
  • notes - Notes
    Example: Sample notes

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Time for a Task

This call returns details of Time for a Task based on the filters specified. The subtotals parameter allows you to return Sub Totals of time tracked. The fields parameter allows you to return individual Time Records and choose which data fields to return for each Time Record.

REQUIRED PARAMETERS:

trackedfrom
default: -6d
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
trackedto
default: +0d
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FIELD PARAMETERS:

fields
Fields to return - if not specified then only Total/Sub Totals will be returned.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approvalstatus
    • billable
    • category (Project Category)
    • company
    • contact
    • dates
    • lastmodified
    • notes
    • project
    • task
    • tasktimetotals (Total allocated/tracked time for the task)
    • timetracked
    Example: contact,task,timetracked
  • none - return only Total/Subtotals
subtotals
Sub Totals - if not specified then only Total/Fields will be returned.
  • Comma separated list of any of the following in the required order:
    • billable
    • category
    • company
    • contact
    • project
    • task

    • day
    • week
    • month
    • year
    • If week is used then the 'trackedfrom' date will be used as the first day of the week.
      Example: contact,company - return Sub Totals of Time Tracked for each combination of Contact and Company.
      NOTE - Only non-zero Sub Totals will be returned.

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

approvalstatus
default: all
Approval Status.
  • approved - Approved Time Records
  • locked - Locked Time Records
  • submitted - Submitted Time Records
  • open - Open Time Records (Not approved, locked or submitted)
  • closed - Closed Time Records (Approved, locked or submitted)
  • all - All Time Records
billable
default: all
Billable status.
  • billable - Billable Time
  • nonbillable - Non-Billable Time
  • all - All Time
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • me - Time Tracked by Contact making request
  • all - Time Tracked by All Contact

SORT/PAGE PARAMETERS:

sortby
default: id
Sort field for Time Records.
  • id - Time Record ID
  • date - Time Record Date
  • taskid - Task ID
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Time Record

This call adds a single Time Record to a Task. The following combinations of starttime, endtime and timetracked can be specified:

  • starttime & endtime - Start and end time (time tracked will be calculated automatically)
  • starttime & timetracked - Start time and minutes tracked (end time will be calculated automatically)
  • endtime & timetracked - End time and minutes tracked (start time will be calculated automatically)
  • timetracked - Minutes tracked (end time will be set as current time, start time will be calculated automatically)

Show Sample POST data

{
   "starttime":"2014-03-20T13:00",
   "timetracked":60,
   "notes":"Sample notes"
}

REQUIRED PARAMETERS:

endtime
End Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
starttime
Start Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
timetracked
Time Tracked.
  • timetracked - Time Tracked (minutes)
    Example: 60

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
    { "id":1, "value":"Europe"},
    { "id":2, "value":"Industrial"}
    ]
contactid
default: me
Contact.
  • contactid - Add Time Record for Contact ID
    Example: 1
  • me - Add Time Record for Contact making request
notes
Notes.
  • notes - Notes
    Example: Sample notes

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete multiple Project Tasks

This call deletes multiple Project Tasks, this will also delete all Files, Messages & Time Records for the Tasks. The Task IDs must all belong to the same Project. Please use this endpoint with caution.

REQUIRED PARAMETERS:

taskid
Task ID/s.
  • taskid - Task ID/s
    Example: 1,2,3

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Overdue Tasks

This call returns a list of Overdue Tasks based on the specified filters. The fields parameter allows you to choose which data fields to return for each Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,type,order,project,startdate,duedate
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • billable
    • category
    • company
    • completedate
    • contacts
    • creator
    • (contact who added this Task)
    • dates (returns start/due/complete)
    • dependent (returns currenttask status and prerequisites)
    • description
    • duedate
    • lastmodified
    • name
    • order
    • priority
    • project
    • (returns ID/Number/Title)
    • projectcategory
    • (returns ID/Name)
    • projectmanager
    • (returns ID/Name)
    • startdate
    • status
    • tags
    • tasklist
    • timeallocated
    • timetracked
    • type
    Example: order,name,project

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Tasks where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Tasks where ANY of the specified apifields match
  • all - Tasks where ALL of the specified apifields match
billable
default: all
Billable status.
  • true - Billable Tasks
  • false - Non-Billable Tasks
  • all - All Tasks
categoryid
Category.
  • categoryid/s - General Tasks in specified Category/ies
    Example: 1,2
  • !categoryid/s - General Tasks NOT in specified Category/ies
    Example: !1,2
companyid
Company.
  • companyid/s - Company ID or List of Company IDs - Tasks in Projects for specified Company/ies
    Example: 1,2
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Tasks assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • me - Tasks assigned to Contact making request
  • unassigned - Unassigned Tasks
  • all - All Tasks
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Tasks assigned to ANY of the specified contacts
  • all - Tasks assigned to ALL of the specified contacts
dependentstatus
default: all
Task Dependent Status.
  • current - Current Tasks
  • noncurrent - Non-Current Tasks
  • all - All Tasks
divisionid
Division ID (Advanced plan only).
  • divisionid - Tasks in specified Division
    Example: 1
generaltasks
default: true
General Tasks.
  • true - Include General Tasks
  • false - Exclude General Tasks
managerid
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Tasks in Projects managed by specified Contact/s
    Example: 1,2
  • me - Tasks in Projects managed by Contact making request
priority
Priority (1-5 representing Very High-Very Low).
  • priority/ies - Tasks with specified Priority/ies
    Example: 1,2
  • !priority/ies - Tasks NOT with specified Priority/ies
    Example: !4,5
projectcategoryid
Project Category ID or List of Project Category IDs.
  • projectcategoryid/s - Tasks in Projects in specified Category/ies
    Example: 1,2,3
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project.
  • projectid/s - Tasks in specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projecttasks
default: true
Project Tasks.
  • true - Include Project Tasks
  • false - Exclude Project Tasks
searchdescription
Search Description.
  • string - Tasks where Description contains string
    Example: website
  • !string - Tasks where Description does not contain string
    Example: !layout
searchname
Search Name.
  • string - Tasks where Name contains string
    Example: website
  • !string - Tasks where Name does not contain string
    Example: !layout
startdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Projects with specified Tag/s
    Example: 1,2,3
  • !tagid/s - Projects without specified Tag/s
    Example: !1,2,3
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timetracked
Tasks where Time Tracked matches criteria.
timetrackedby, timetrackedfrom, timetrackedto parameters apply to the starred options.
  • number* - Time Tracked (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber* - Time Tracked (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber* - Time Tracked (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
  • over - Total Time Tracked is GREATER THAN Allocated Time
  • under - Total Time Tracked is LESS THAN OR EQUAL TO Allocated Time
  • gtenumber% - TOTAL Time Tracked is GREATER THAN OR EQUAL to specified percentage of Allocated Time
    Example: gte30%
  • ltenumber% - TOTAL Time Tracked is LESS THAN OR EQUAL to specified percentage of Allocated Time
    Example: lte30%
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
type
default: all
Task Type.
  • normal - Normal Tasks
  • bold - Bold Tasks
  • heading - Heading Tasks
  • nonheading - Non-Heading Tasks (Normal + Bold)
  • all - All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Tasks.
Example: pagenumber=2&pagesize=10 (return Tasks 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - ID
  • order - Order
  • name - Name
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • projectid - Project ID
  • projectnumber - Project Number
  • projecttitle - Project Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
View Overtime Tasks

This call returns a list of Overtime Tasks based on the specified filters. The fields parameter allows you to choose which data fields to return for each Project.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

fields
default: name,type,order,project,startdate,duedate,timeallocated,timetracked
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • billable
    • category
    • company
    • completedate
    • contacts
    • creator
    • (contact who added this Task)
    • dates (returns start/due/complete)
    • dependent (returns currenttask status and prerequisites)
    • description
    • duedate
    • lastmodified
    • name
    • order
    • priority
    • project
    • (returns ID/Number/Title)
    • projectcategory
    • (returns ID/Name)
    • projectmanager
    • (returns ID/Name)
    • startdate
    • status
    • tags
    • tasklist
    • timeallocated
    • timetracked
    • type
    Example: order,name,project

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma - Tasks where the field contains the specified string
    Example: 2,Europe
  • Multiple API Field ID and String pairs separated by two pipe characters
    NOTE: The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Example: 2,Europe||3,Industrial||3,Commercial
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Tasks where ANY of the specified apifields match
  • all - Tasks where ALL of the specified apifields match
billable
default: all
Billable status.
  • true - Billable Tasks
  • false - Non-Billable Tasks
  • all - All Tasks
categoryid
Category.
  • categoryid/s - General Tasks in specified Category/ies
    Example: 1,2
  • !categoryid/s - General Tasks NOT in specified Category/ies
    Example: !1,2
companyid
Company.
  • companyid/s - Company ID or List of Company IDs - Tasks in Projects for specified Company/ies
    Example: 1,2
completedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
completedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Tasks assigned to ANY/ALL specified Contact/s (see contactsmode parameter)
    Example: 1,2
  • me - Tasks assigned to Contact making request
  • unassigned - Unassigned Tasks
  • all - All Tasks
contactsmode
default: any
Mode used for the contacts parameter.
  • any - Tasks assigned to ANY of the specified contacts
  • all - Tasks assigned to ALL of the specified contacts
dependentstatus
default: all
Task Dependent Status.
  • current - Current Tasks
  • noncurrent - Non-Current Tasks
  • all - All Tasks
divisionid
Division ID (Advanced plan only).
  • divisionid - Tasks in specified Division
    Example: 1
duedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
duedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
generaltasks
default: true
General Tasks.
  • true - Include General Tasks
  • false - Exclude General Tasks
managerid
Manager.
  • managerid/s - Contact ID or List of Contact IDs - Tasks in Projects managed by specified Contact/s
    Example: 1,2
  • me - Tasks in Projects managed by Contact making request
priority
Priority (1-5 representing Very High-Very Low).
  • priority/ies - Tasks with specified Priority/ies
    Example: 1,2
  • !priority/ies - Tasks NOT with specified Priority/ies
    Example: !4,5
projectcategoryid
Project Category ID or List of Project Category IDs.
  • projectcategoryid/s - Tasks in Projects in specified Category/ies
    Example: 1,2,3
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project.
  • projectid/s - Tasks in specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstatus
default: all
Project Status.
  • active - Tasks in Active Projects
  • complete - Tasks in Completed Projects
  • all - Tasks in All Projects
projecttasks
default: true
Project Tasks.
  • true - Include Project Tasks
  • false - Exclude Project Tasks
searchdescription
Search Description.
  • string - Tasks where Description contains string
    Example: website
  • !string - Tasks where Description does not contain string
    Example: !layout
searchname
Search Name.
  • string - Tasks where Name contains string
    Example: website
  • !string - Tasks where Name does not contain string
    Example: !layout
startdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
startdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
status
default: active
Task Status.
  • active - Active Tasks
  • complete - Completed Tasks
  • all - All Tasks
tagid
Tag ID or List of Tag IDs.
  • tagid/s - Projects with specified Tag/s
    Example: 1,2,3
  • !tagid/s - Projects without specified Tag/s
    Example: !1,2,3
timeallocated
Time Allocated.
  • number - Time Allocated (minutes) is EXACTLY the specified value
    Example: 300
  • gtenumber - Time Allocated (minutes) is GREATER THAN OR EQUAL to specified value
    Example: gte300
  • ltenumber - Time Allocated (minutes) is LESS THAN OR EQUAL to specified value
    Example: lte300
timetrackedby
default: all
Time Tracked By.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • !contactid/s - Contact ID or List of Contact IDs - Time NOT Tracked by specified Contact/s
    Example: !1,2
  • me - Time Tracked by Contact making request
  • all - All Time Tracked
timetrackedfrom
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
timetrackedto
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
type
default: all
Task Type.
  • normal - Normal Tasks
  • bold - Bold Tasks
  • heading - Heading Tasks
  • nonheading - Non-Heading Tasks (Normal + Bold)
  • all - All Tasks

SORT/PAGE PARAMETERS:

pagenumber
Page Number (must be used with pagesize) to return a subset of Tasks.
Example: pagenumber=2&pagesize=10 (return Tasks 11-20).
  • pagenumber
pagesize
Page Size (must be used with pagenumber).
  • pagesize
sortby
default: id
Sort field.
  • id - ID
  • order - Order
  • name - Name
  • startdate - Start Date
  • duedate - Due Date
  • completedate - Complete Date
  • projectid - Project ID
  • projectnumber - Project Number
  • projecttitle - Project Title
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending

DELETE PUT POST GET

Staff
Client
Contractor
View Time Records/Totals

This call returns the time tracked and/or time records based on the filters specified, it also returns the total time tracked based on the filters specified. The subtotals parameter allows you to return Sub Totals of time tracked. Specifying the fields parameter will return a list of Time Records with the specified data fields.

REQUIRED PARAMETERS:

trackedfrom
default: -6d
Time tracked on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
trackedto
default: +0d
Time Tracked on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FIELD PARAMETERS:

fields
Fields to return.
  • Comma separated list of any of the following:
    • apifieldX (returns API Field ID X, specify for each required Field)
    • apifields (returns all API Fields)
    • approvalstatus
    • billable
    • category (Project Category)
    • company
    • contact
    • dates
    • lastmodified
    • notes
    • project
    • task
    • tasktimetotals (Total allocated/tracked time for the task)
    • timetracked
    Example: contact,task,timetracked
  • none - return only Total/Subtotals
subtotals
Sub Totals to return - if not specified then only Fields and/or Total will be returned.
  • Comma separated list of any of the following in the required order:
    • billable
    • category
    • company
    • contact
    • group (Advanced plan only, Group in charge of Project)
    • internalclientgroup (Advanced plan only, Group of Internal Client for Project)
    • internalclientteam (Advanced plan only, Team of Internal Client for Project)
    • project
    • task
    • team (Advanced plan only, Team in charge of Project)

    • day
    • week
    • month
    • year
    • If week is used then the 'trackedfrom' date will be used as the first day of the week.
      Example: contact,company - return Sub Totals of Time Tracked for each combination of Contact and Company.
      NOTE - Only non-zero Sub Totals will be returned.

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

apifields
API Field Value/s
  • apifieldid,string - An API Field ID and String separated by a comma (Example: 2,Europe) - Time Records where the field contains the specified string
  • Multiple API Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    The same API Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
apifieldsmode
default: any
Mode used for the apifields parameter.
  • any - Time Records where ANY of the specified apifields match
  • all - Time Records where ALL of the specified apifields match
approvalstatus
default: all
Status.
  • approved - Approved Time Records
  • locked - Locked Time Records
  • submitted - Submitted Time Records
  • open - Open Time Records (Not approved, locked or submitted)
  • closed - Closed Time Records (Approved, locked or submitted)
  • all - All Time Records
billable
default: all
Billable status.
  • billable - Billable Time
  • nonbillable - Non-Billable Time
  • all - All Time
categoryid
Project Category ID or List of Project Category IDs.
  • categoryid/s - Time for Projects in specified Category/ies
    Example: 1,2
companyid
Company ID or List of Company IDs.
  • companyid/s - Time in specified Company/ies
    Example: 1,2,3
contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Time Tracked by specified Contact/s
    Example: 1,2
  • me - Time Tracked by Contact making request
  • all - Time Tracked by All Contact
divisionid
Division ID (Advanced plan only).
  • divisionid - Time in specified Division
    Example: 1
generaltasks
default: true
General Tasks.
  • true - Include Time for General Tasks
  • false - Exclude Time for General Tasks
groupid
Group ID or List of Group IDs.
  • groupid/s - Time in Projects managed by specified Group/s
    Example: 1,2,3
id
List of Time Record IDs.
  • id/s - ID
    Example: 1,2,3,4
idfrom
Time Records with ID less than or equal to this value .
  • id - ID
    Example: 1
idto
Time Records with ID greater than or equal to this value .
  • id - ID
    Example: 1
internalclientcontactid
Contact ID or List of Contact IDs.
  • contactid/s - Time in Projects where specified Contact/s are the main Internal Client Contact
    Example: 1,2,3
internalclientgroupid
Group ID or List of Group IDs.
  • groupid/s - Time in Projects for specified Group/s
    Example: 1,2,3
internalclientteamid
Team ID or List of Team IDs.
  • companyid/s - Time in Projects for specified Team/s
    Example: 1,2,3
lastmodifiedfrom
Time Records added/edited on or after this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedto
Time Records added/edited on or before this date.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcfrom
Time Records added/edited on or after this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
lastmodifiedutcto
Time Records added/edited on or before this date (UTC time).
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • Xn/h/d/w/m - X minutes/hours/days/weeks/months ago
    Example: 12h
managerid
Project Manager.
  • contactid/s - Contact ID or List of Contact IDs - Time in Projects managed by specified Contact/s
    Example: 1,2
  • me - Time in Projects managed by Contact making request
projectcompletedatefrom
Projects completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcompletedateto
Projects completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectcustomfieldoptionid
Custom Field Option ID/s (Advanced plan only)
  • customfieldoptionid/s - Projects with specified Custom Field Option/s (applies only to custom fields of dropdown type)
    Example: 1,2
projectcustomfields
Custom Field Value/s (Advanced plan only)
  • customfieldid,string - A Custom Field ID and String separated by a comma (Example: 2,Europe) - Tasks in Projects where the field matches the specified string.
    Example: 2,Europe

  • Multiple Custom Field ID and String pairs separated by two pipe characters
    Example: 2,Europe||3,Industrial||3,Commercial
    NOTE: The same Custom Field ID can be passed more than once to search for multiple values if apifieldsmode is set to any
    Dates should be sent in 'YYYY-MM-DD' format, date times should be sent in 'YYYY-MM-DD HH:MM' format
    Text fields require an exact match
    Checkbox values should be sent as 'checked' or 'unchecked'
projectcustomfieldsmode
default: any
Mode used for the customfields or customfieldoptionid parameter.
  • any - Projects where ANY of the specified customfields match
  • all - Projects where ALL of the specified customfields match
  • none - Projects where NONE of the specified customfields match
projectcustomstatusid
Custom Status ID or List of Custom Status IDs (Advanced plan only).
  • projectcustomstatusid/s - Projects with specified Custom Status/es
    Example: 1,2
  • !projectcustomstatusid/s - Projects without specified Custom Status/es
    Example: !1,2
projectduedatefrom
Projects due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectduedateto
Projects due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectid
Project ID or List of Project IDs.
  • projectid/s - Time for specified Project/s
    Example: 1,2
projectstartdatefrom
Projects starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstartdateto
Projects starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
projectstatus
default: all
Project Status.
  • active - Active Projects
  • complete - Completed Projects
  • all - All Projects
projecttasks
default: true
Project Tasks.
  • true - Include Time for Project Tasks
  • false - Exclude Time for Project Tasks
searchnotes
Search Notes.
  • string - Time Records where Notes contain string
    Example: website
  • !string - Time Records where Notes do not contain string
    Example: !layout
searchtask
Search Task.
  • string - Time Records where Task Name contains string
    Example: website
  • !string - Time Records where Task Name does not contain string
    Example: !layout
taskcompletedatefrom
Tasks completed on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskcompletedateto
Tasks completed on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedatefrom
Tasks due on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskduedateto
Tasks due on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskid
Task ID or List of Task IDs.
  • taskid/s - Time for specified Task/s
    Example: 1,2
taskstartdatefrom
Tasks starting on or after this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskstartdateto
Tasks starting on or before this date.
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead
taskstatus
default: all
Task Status.
  • active - Active Tasks
  • complete - Completed Tasks
  • all - All Tasks
taxable
default: all
Taxable status.
  • taxable - Taxable Time
  • nontaxable - Non-Taxable Time
  • all - All Time
teamid
Team ID or List of Team IDs.
  • teamid/s - Time in Projects managed by specified Team/s
    Example: 1,2,3

SORT/PAGE PARAMETERS:

sortby
default: id
Sort field for Time Records.
  • id - Time Record ID
  • date - Time Record Date
  • taskid - Task ID
  • projectid - Project ID
sortorder
default: asc
Sort order.
  • asc - Ascending
  • desc - Descending
Staff
Client
Contractor
Add a Time Record

This call adds a single Time Record to a Task. The following combinations of starttime, endtime and timetracked can be specified:

  • starttime & endtime - Start and end time (time tracked will be calculated automatically)
  • starttime & timetracked - Start time and minutes tracked (end time will be calculated automatically)
  • endtime & timetracked - End time and minutes tracked (start time will be calculated automatically)
  • timetracked - Minutes tracked (end time will be set as current time, start time will be calculated automatically)

Show Sample POST data

{
   "taskid":1,
   "starttime":"2014-03-20T13:00",
   "timetracked":60,
   "notes":"Sample notes"
}

REQUIRED PARAMETERS:

endtime
End Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
starttime
Start Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
taskid
Task ID.
  • taskid - Task ID
    Example: 1
timetracked
Time Tracked.
  • timetracked - Time Tracked (minutes)
    Example: 60

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
contactid
default: me
Contact.
  • contactid - Add Time Record for Contact ID
    Example: 1
  • me - Add Time Record for Contact making request
notes
Notes.
  • notes - Notes
    Example: Sample notes

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Delete a Time Record

This call deletes a single Time Record.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View a Time Record

This call returns details of a single Time Record.
If the Time Record is running then the active field will be returned as true and timetrackedseconds will return the number of seconds tracked so far and timetracked will return the number of minutes tracked so far.
If the Time Record is complete then active will be returned as false and timetracked will return the number of minutes tracked

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Edit a Time Record

This call updates a single Time Record. The following combinations of starttime, endtime and timetracked can be specified:

  • starttime & endtime - Start and end time (time tracked will be calculated automatically)
  • starttime & timetracked - Start time and minutes tracked (end time will be calculated automatically)
  • endtime & timetracked - End time and minutes tracked (start time will be calculated automatically)
  • starttime - Start Time (End Time will be calculated automatically, time tracked will not be changed)
  • endtime - End Time (Start Time will be calculated automatically, time tracked will not be changed)
  • timetracked - Minutes tracked (end time will be calculated automatically based on existing start time)

Show Sample PUT data

{
   "starttime":"2014-03-20T13:00",
   "timetracked":60,
   "notes":"Sample notes"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

apifields
API Field Value/s
  • apifields - API Fields
    You must specify id and value (use the settings/apifields call for a list of fields).
    Example:
    [
       {
          "id":1, "value":"Europe"
       },
       {
          "id":2, "value":"Industrial"
       }
    ]
contactid
Contact.
  • contactid - Assign Time Record to Contact ID
    Example: 1
  • me - Assign Time Record to Contact making request
endtime
End Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
notes
Notes.
  • notes - Notes
    Example: Sample notes
starttime
Start Time.
  • Specific date & time - Date in ISO8601 (yyyy-mm-ddThh:mm) format
    Example: 2014-01-18T13:20
  • now - Current time
timetracked
Time Tracked.
  • timetracked - Time Tracked (minutes)
    Example: 60

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
Stop a Timer

This call stops a timer.
Show Sample PUT data

{
   "notes":"Sample notes"
}

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

notes
Notes.
  • notes - Notes
    Example: Sample notes

FILTER PARAMETERS:

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Active Timers

This call returns a list of Active Timers.
Staff without Show Info permission will only be able to view their own Timer.
timetrackedseconds is the number of seconds tracked so far, timetracked is the number of whole minutes tracked so far.

REQUIRED PARAMETERS:

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

FILTER PARAMETERS:

contacts
default: all
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Timers for specified Contact/s
    Example: 1,2
  • me - Timer for Contact making request
  • all - All Timers
divisionid
Division ID (Advanced plan only).
  • divisionid - Active Timers for specified Division
    Example: 1

SORT/PAGE PARAMETERS:

Staff
Client
Contractor
View Workload

This call returns upcoming workload or availability in minutes for one or more users for every day in the specified date range. Weekends are automatically excluded from calculations but are included in the return data to make it easier to work with.
Overdue Tasks are NOT included in the Workload calculation

REQUIRED PARAMETERS:

datefrom
default: +0d
Workload from date (must be today or later).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y (Example: +3w - 3 weeks ahead, +1m - 1 month ahead)
dateto
default: +2w
Workload to date (must be today or later).
  • Specific date - Date in yyyy-mm-dd format
    Example: 2014-01-18
  • Relative date - +/-Xd/w/m/y
    Examples: -3w - 3 weeks ago OR +1m - 1 month ahead

FIELD PARAMETERS:

OPTIONAL PARAMETERS:

availableminutes
default: 480
Available minutes.
  • availableminutes - Number of minutes each contact can work each day
    Example: 300
mode
default: workload
Mode.
  • workload - Return workload
  • availability - Return availability (availableminutes - workload)

FILTER PARAMETERS:

categoryid
Category ID or List of Category IDs.
  • categoryid/s - Category ID or List of Category IDs - Workload for specified Category/ies
    Example: 1,2
companyid
Company ID or List of Company IDs.
  • companyid/s - Company ID or List of Company IDs - Workload for specified Company/ies
    Example: 1,2
contacts
default: me
Contacts.
  • contactid/s - Contact ID or List of Contact IDs - Workload for specified Staff
    Example: 1,2
  • me - Workload for Contact making request
  • all - Workload for All Staff
divisionid
Division ID (Advanced plan only).
  • divisionid - Workload in specified Division
    Example: 1

SORT/PAGE PARAMETERS: