Use the departments method to create, update, and get info on all or one department.
API Documentation on Postman
Our API Documentation is now available on Postman which includes code samples, interactive documentation, and so much more.
Depreciation Notice
The below documentation is for our v1 Departments API endpoint.
For a better API experience, you’ll want to use our newer v2 Departments API endpoint.
Request URL:
https://YOURAPPNAME.fusedesk.com/api/v1/departments/
Supported Methods: GET, POST
Authorization: See Authorization
Return Codes: See Return Codes
Get a list of all Departments
Supported Methods: GET
Request URL: https://YOURAPPNAME.fusedesk.com/api/v1/departments/
Parameters: none
Department List Sub Methods:
- all – get a list of ALL departments, both active and archived
https://YOURAPPNAME.fusedesk.com/api/v1/departments/all - archived – get a list of all archived departments
https://YOURAPPNAME.fusedesk.com/api/v1/departments/archived
Example JSON Response:
[
{
"departmentid": 268,
"name": "Support",
"repids": [
1,
2,
3,
4
]
},
{
"departmentid": 272,
"name": "Billing",
"repids": [
1,
3
]
},
{
"departmentid": 273,
"name": "Affiliates",
"repids": [
3
]
}
]Get information on one Department
Supported Methods: GET
Request URL: https://YOURAPPNAME.fusedesk.com/api/v1/departments/DEPARTMENTID
Parameters: none
Example JSON Response:
{
"departmentid": 268,
"name": "Support",
"repids": [
1,
2,
3,
4
]
}Create a New Department
Supported Methods: POST
Request URL: https://YOURAPPNAME.fusedesk.com/api/v1/departments/
Parameters:
| Field | Type | Required | Info |
| name | string | Yes | The name of your new department |
| reps | array or CSV | No | The IDs of the reps you want in the department |
| replytemplate | int | No | The Infusionsoft Template ID of the default reply template |
| templatecategory | string | No | The Infusionsoft template category to use in this department |
| stalewarning | int | No | How many hours to wait before a case goes from green to yellow |
| stale | int | No | How many hours to wait before a case goes from yellow to red |
| feedbackdelay | int | No | How many days to wait after a case is closed before asking for feedback |
| feedbacksample | int | No | What percent of cases to request feedback on (0-100) |
| feedbacktemplate | int | No | The Infusionsoft Template ID to send when asking for feedback |
Update an Existing Department
Supported Methods: POST
Parameters: same as for creating a department (see above)
Request URL: https://YOURAPPNAME.fusedesk.com/api/v1/departments/DEPARTMENTID
Department Update Sub Methods:
- archive – Archive the specified department https://YOURAPPNAME.fusedesk.com/api/v1/departments/DEPARTMENTID/archive
- restore – Restore the specified department https://YOURAPPNAME.fusedesk.com/api/v1/departments/DEPARTMENTID/restore