Datto Autotask PSA
App · 25 actions
Run your Autotask service desk from workflows: create, update and find tickets, add notes, log time, manage companies, contacts, projects and tasks, and start a workflow when a ticket is created, updated, changes status or is assigned.
Actions
| Action | What it does |
|---|---|
| Add ticket note | Add a note to a ticket. |
| Create company | Add a company (a customer, lead, prospect or vendor). |
| Create contact | Add a contact (a person at a customer) to a company. |
| Create project | Start a project for a company. |
| Create task | Add a task to a project. |
| Create ticket | Open a service desk ticket for a company. |
| Delete contact | Delete a contact. |
| Delete time entry | Delete a time entry that isn't on a submitted timesheet or posted yet. |
| Find companies | Find companies by name, type, phone or when they were added, oldest first. |
| Find configuration items | Find a company's devices and other configuration items by name, serial number or type, oldest first. |
| Find contacts | Find contacts by email, name or company, oldest first. |
| Find projects | Find projects by name, company, status or type, oldest first. |
| Find resources | Find Autotask users (resources) by name or email, for their ids. |
| Find tasks | Find project tasks by project, title, status or resource, oldest first. |
| Find tickets | Find tickets by number, title, company, contact, status, priority, queue, resource or date, oldest first. |
| Find time entries | Find time logged on a ticket or task, by a resource, or between two days, oldest first. |
| Get company | Get a company by its id, with its type, address and a link to open it. |
| Get ticket | Get a ticket by its id or ticket number, with its status, priority, queue and a link to open it. |
| List ticket notes | List a ticket's notes, oldest first. |
| Log time | Log time a resource worked on a ticket or a project task. |
| Update company | Change a company's name, type, contact details or account manager, or make it inactive. |
| Update contact | Change a contact's name, email, phone or job title, or make them inactive. |
| Update project | Change a project's name, status (Complete completes its tasks too), end date, description or lead. |
| Update task | Change a project task's title, status (such as Complete), description, estimate or due date. |
| Update ticket | Change a ticket: its status (such as Complete), priority, queue, due date, resource, resolution and other fields. |
Add ticket note
Add a note to a ticket. Who can see it and its type default to the account's defaults.
Inputs
- Ticket
ticket_idtextRequired - The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
- Note
descriptiontextRequired - The text of the note (plain text, up to 32,000 characters).
- Title
titletext - A title. Some ticket categories require one.
- Note type
note_typetext - Pick one, or give its id or name.
- Who can see it
publishtext - All Autotask users, internal users only, and so on. Pick one, or give its id or name.
Outputs
noteobject- The note
Example output
{
"note": {
"create_date_time": "2026-05-14T10:03:10Z",
"created_by_contact_id": null,
"created_by_resource_id": 29682885,
"description": "Restarted the print spooler; printer is back online.",
"id": 30199871,
"last_activity_date": "2026-05-14T10:03:10Z",
"note_type": 1,
"note_type_label": "Task Detail",
"publish": 1,
"publish_label": "All Autotask Users",
"ticket_id": 12345,
"title": "Called the customer"
}
}Create company
Add a company (a customer, lead, prospect or vendor).
Inputs
- Name
company_nametextRequired - The company's name.
- Phone
phonetextRequired - The company's phone number. Autotask requires it.
- Account manager
owner_resource_idtextRequired - The resource who owns the company. It must be a person, not an API user.
- Type
company_typetext - Customer, Lead, Prospect, Vendor and so on. Defaults to the account's default (Customer).
- Website
web_addresstext - The company's website.
- Address line 1
address1text - Street address.
- Address line 2
address2text - Second address line.
- City
citytext - City.
- State or region
statetext - State, county or region.
- Postal code
postal_codetext - ZIP or postal code.
- User-defined fields
custom_fieldsobject - Values for the account's user-defined company fields.
Outputs
companyobject- The company
Example output
{
"company": {
"address1": "12 High Street",
"address2": "",
"city": "Springfield",
"company_name": "Northwind Dental",
"company_number": "NWD-001",
"company_type": 1,
"company_type_label": "Customer",
"country_id": 237,
"create_date": "2024-02-01T15:20:00Z",
"id": 174,
"is_active": true,
"last_activity_date": "2026-05-14T10:03:10Z",
"owner_resource_id": 29682885,
"parent_company_id": null,
"phone": "555-0100",
"postal_code": "62701",
"state": "IL",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenAccount&AccountID=174",
"user_defined_fields": {
"Contract tier": "Gold"
},
"web_address": "https://northwind.example.com"
}
}Create contact
Add a contact (a person at a customer) to a company.
Inputs
- Company
company_idtextRequired - The company (customer). Pick one, or give its id.
- First name
first_nametextRequired - The contact's first name.
- Last name
last_nametextRequired - The contact's last name.
- Email
emailtext - Email address.
- Phone
phonetext - Phone number.
- Mobile phone
mobile_phonetext - Mobile number.
- Job title
titletext - Their job title.
Outputs
contactobject- The contact
Example output
{
"contact": {
"city": "Springfield",
"company_id": 174,
"create_date": "2024-02-01T15:25:00Z",
"email": "ana.lopez@example.com",
"first_name": "Ana",
"id": 30684512,
"is_active": true,
"last_activity_date": "2026-05-14T09:12:44Z",
"last_modified_date": "2026-04-02T08:00:00Z",
"last_name": "Lopez",
"mobile_phone": "555-0199",
"phone": "555-0101",
"primary_contact": true,
"state": "IL",
"title": "Office manager",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenContact&ContactID=30684512",
"user_defined_fields": {},
"zip_code": "62701"
}
}Create project
Start a project for a company. Status and type default to the account's defaults.
Inputs
- Company
company_idtextRequired - The company (customer). Pick one, or give its id.
- Name
project_nametextRequired - The project's name.
- End date
end_datedateRequired - When the project should finish.
- Start date
start_datedate - When it starts. Defaults to today (UTC).
- Status
statustext - Pick one, or give its id or name. Defaults to the account's default.
- Type
project_typetext - Client, Internal, Proposal or Template. Defaults to the account's default.
- Description
descriptiontext - What it is about.
- Project lead
project_lead_resource_idtext - The resource leading it.
Outputs
projectobject- The project
Example output
{
"project": {
"actual_hours": 4.0,
"company_id": 174,
"completed_date_time": "",
"completed_percentage": 10,
"create_date_time": "2026-04-20T12:00:00Z",
"description": "Move the practice to the new building.",
"end_date_time": "2026-06-30T00:00:00Z",
"estimated_time": 40.0,
"id": 2001,
"last_activity_date_time": "2026-05-10T16:00:00Z",
"project_lead_resource_id": 29682885,
"project_name": "Office move",
"project_number": "P20260501.0003",
"project_type": 5,
"project_type_label": "Client",
"start_date_time": "2026-05-01T00:00:00Z",
"status": 1,
"status_detail": "",
"status_label": "New",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenProject&ProjectID=2001",
"user_defined_fields": {}
}
}Create task
Add a task to a project. Status and type default to the account's defaults.
Inputs
- Project
project_idtextRequired - The project's id.
- Title
titletextRequired - What the task is.
- Status
statustext - Pick one, or give its id or name. Defaults to the account's default.
- Type
task_typetext - Fixed Work or Fixed Duration. Defaults to the account's default.
- Description
descriptiontext - What it is about.
- Estimated hours
estimated_hoursnumber - Hours it should take.At least 0.
- Start
start_date_timedate and time - When work on it starts.
- Due date
end_datedate - When it is due.
Outputs
taskobject- The task
Example output
{
"task": {
"assigned_resource_id": null,
"assigned_role_id": null,
"completed_date_time": "",
"create_date_time": "2026-04-20T12:05:00Z",
"description": "",
"end_date_time": "2026-05-09T00:00:00Z",
"estimated_hours": 2.0,
"id": 7001,
"last_activity_date_time": "2026-04-20T12:05:00Z",
"phase_id": null,
"project_id": 2001,
"remaining_hours": 2.0,
"start_date_time": "2026-05-02T09:00:00Z",
"status": 1,
"status_label": "New",
"task_number": "T20260501.0003.001",
"task_type": 1,
"task_type_label": "Fixed Work",
"title": "Order network cabling",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenTaskDetail&TaskID=7001",
"user_defined_fields": {}
}
}Create ticket
Open a service desk ticket for a company. Status, priority and queue default to the account's defaults.
Inputs
- Company
company_idtextRequired - The company (customer). Pick one, or give its id.
- Title
titletextRequired - A short summary of the request.
- Description
descriptiontext - What it is about.
- Status
statustext - Pick one, or give its id or name. Defaults to the account's default (New).
- Priority
prioritytext - Pick one, or give its id or name. Defaults to the account's default.
- Queue
queue_idtext - The service desk queue. Pick one, or give its id or name.
- Due
due_date_timedate and time - When it is due. Autotask needs one unless the ticket category sets a default due date.
- Issue type
issue_typetext - Pick one, or give its id or name.
- Sub-issue type
sub_issue_typetext - Pick one of the issue type's sub-issue types, or give its id or name.
- Ticket type
ticket_typetext - Service Request (Autotask's default), Incident, Problem or Change Request.
- Source
sourcetext - How the request came in, such as Phone or Email.
- Contact
contact_idtext - The contact's id. The contact must belong to the ticket's company.
- Primary resource
assigned_resource_idtext - The resource (user) to assign it to.
- Role
assigned_role_idtext - The role the resource works it in. Defaults to their default service desk role.
- Configuration item
configuration_item_idtext - The id of the device or other configuration item it is about.
- Estimated hours
estimated_hoursnumber - Hours it should take.At least 0.
- User-defined fields
custom_fieldsobject - Values for the account's user-defined ticket fields.
Outputs
ticketobject- The ticket
Example output
{
"ticket": {
"assigned_resource_id": 29682885,
"assigned_role_id": 29683461,
"company_id": 174,
"completed_date": "",
"configuration_item_id": null,
"contact_id": 30684512,
"contract_id": null,
"create_date": "2026-05-14T09:12:44Z",
"created_by_resource_id": 29682885,
"description": "The reception printer shows as offline for everyone.",
"due_date_time": "2026-05-15T17:00:00Z",
"estimated_hours": 1.5,
"external_id": "",
"first_response_date_time": "2026-05-14T09:30:00Z",
"id": 12345,
"issue_type": 4,
"issue_type_label": "Hardware",
"last_activity_date": "2026-05-14T10:03:10Z",
"priority": 2,
"priority_label": "Medium",
"project_id": null,
"purchase_order_number": "",
"queue": "Level I Support",
"queue_id": 29683354,
"resolution": "",
"resolved_date_time": "",
"source": 4,
"source_label": "Phone",
"status": 1,
"status_label": "New",
"sub_issue_type": 31,
"sub_issue_type_label": "Printer",
"ticket_category": 3,
"ticket_category_label": "Standard",
"ticket_number": "T20260514.0042",
"ticket_type": 1,
"ticket_type_label": "Service Request",
"title": "Printer offline in reception",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenTicketDetail&TicketID=12345",
"user_defined_fields": {
"Site": "Head office"
}
}
}Delete contact
Delete a contact. Autotask refuses when the contact is on a ticket or task; make them inactive instead.
Inputs
- Contact
contact_idtextRequired - The contact's id.
Outputs
deletedtrue/false- Always true once deleted
idnumber- The id of what was deleted
Example output
{
"deleted": true,
"id": 30684512
}Delete time entry
Delete a time entry that isn't on a submitted timesheet or posted yet.
Inputs
- Time entry
time_entry_idtextRequired - The time entry's id, from 'Log time' or 'Find time entries'.
Outputs
deletedtrue/false- Always true once deleted
idnumber- The id of what was deleted
Example output
{
"deleted": true,
"id": 51200
}Find companies
Find companies by name, type, phone or when they were added, oldest first.
Inputs
- Name contains
name_containstext - Only companies whose name has this text.
- Types
company_typeslist - Only companies of these types.
- Phone
phonetext - Only companies with exactly this phone number.
- Active or inactive
activetext - Only active ones, only inactive ones, or both.One of:
active(Active only (default)),inactive(Inactive only),all(Active and inactive). Default:active. - Added on or after
created_afterdate and time - Only companies added from then.
- Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
companieslist- The companies, oldest first
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
Example output
{
"companies": [
{
"address1": "12 High Street",
"address2": "",
"city": "Springfield",
"company_name": "Northwind Dental",
"company_number": "NWD-001",
"company_type": 1,
"company_type_label": "Customer",
"country_id": 237,
"create_date": "2024-02-01T15:20:00Z",
"id": 174,
"is_active": true,
"last_activity_date": "2026-05-14T10:03:10Z",
"owner_resource_id": 29682885,
"parent_company_id": null,
"phone": "555-0100",
"postal_code": "62701",
"state": "IL",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenAccount&AccountID=174",
"user_defined_fields": {
"Contract tier": "Gold"
},
"web_address": "https://northwind.example.com"
}
],
"count": 1,
"has_more": false
}Find configuration items
Find a company's devices and other configuration items by name, serial number or type, oldest first.
Inputs
- Company
company_idtext - Only this company's. Pick one, or give its id.
- Name contains
name_containstext - Only items whose name (reference title) has this text.
- Serial number
serial_numbertext - Only the item with exactly this serial number.
- Types
configuration_item_typeslist - Only items of these types.
- Active or inactive
activetext - Only active ones, only inactive ones, or both.One of:
active(Active only (default)),inactive(Inactive only),all(Active and inactive). Default:active. - Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
configuration_itemslist- The configuration items, oldest first
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
Example output
{
"configuration_items": [
{
"company_id": 174,
"configuration_item_type": 1,
"configuration_item_type_label": "Workstation",
"contact_id": null,
"create_date": "2024-03-01T10:00:00Z",
"hostname": "RECEPTION-PC",
"id": 880,
"install_date": "2024-03-01T00:00:00Z",
"ip_address": "10.0.0.21",
"is_active": true,
"last_modified_time": "2026-05-01T07:00:00Z",
"location": "Reception",
"notes": "",
"operating_system": "Microsoft Windows 11 Pro",
"product_id": 232,
"reference_number": "",
"reference_title": "RECEPTION-PC",
"serial_number": "5CG1234XYZ",
"user_defined_fields": {},
"warranty_expiration_date": "2027-03-01T00:00:00Z"
}
],
"count": 1,
"has_more": false
}Find contacts
Find contacts by email, name or company, oldest first.
Inputs
- Email
emailtext - Only the contact with exactly this email address.
- Name contains
name_containstext - Only contacts whose first or last name has this text.
- Company
company_idtext - Only this company's. Pick one, or give its id.
- Active or inactive
activetext - Only active ones, only inactive ones, or both.One of:
active(Active only (default)),inactive(Inactive only),all(Active and inactive). Default:active. - Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
contactslist- The contacts, oldest first
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
Example output
{
"contacts": [
{
"city": "Springfield",
"company_id": 174,
"create_date": "2024-02-01T15:25:00Z",
"email": "ana.lopez@example.com",
"first_name": "Ana",
"id": 30684512,
"is_active": true,
"last_activity_date": "2026-05-14T09:12:44Z",
"last_modified_date": "2026-04-02T08:00:00Z",
"last_name": "Lopez",
"mobile_phone": "555-0199",
"phone": "555-0101",
"primary_contact": true,
"state": "IL",
"title": "Office manager",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenContact&ContactID=30684512",
"user_defined_fields": {},
"zip_code": "62701"
}
],
"count": 1,
"has_more": false
}Find projects
Find projects by name, company, status or type, oldest first.
Inputs
- Name contains
name_containstext - Only projects whose name has this text.
- Company
company_idtext - Only this company's. Pick one, or give its id.
- Statuses
statuseslist - Only projects in these statuses.
- Types
project_typeslist - Only projects of these types.
- Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
projectslist- The projects, oldest first
Example output
{
"count": 1,
"has_more": false,
"projects": [
{
"actual_hours": 4.0,
"company_id": 174,
"completed_date_time": "",
"completed_percentage": 10,
"create_date_time": "2026-04-20T12:00:00Z",
"description": "Move the practice to the new building.",
"end_date_time": "2026-06-30T00:00:00Z",
"estimated_time": 40.0,
"id": 2001,
"last_activity_date_time": "2026-05-10T16:00:00Z",
"project_lead_resource_id": 29682885,
"project_name": "Office move",
"project_number": "P20260501.0003",
"project_type": 5,
"project_type_label": "Client",
"start_date_time": "2026-05-01T00:00:00Z",
"status": 1,
"status_detail": "",
"status_label": "New",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenProject&ProjectID=2001",
"user_defined_fields": {}
}
]
}Find resources
Find Autotask users (resources) by name or email, for their ids.
Inputs
- Name contains
searchtext - Only resources whose name or user name has this text.
- Email
emailtext - Only the resource with exactly this email address.
- Active or inactive
activetext - Only active ones, only inactive ones, or both.One of:
active(Active only (default)),inactive(Inactive only),all(Active and inactive). Default:active. - Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
resourceslist- The resources, oldest first
Example output
{
"count": 1,
"has_more": false,
"resources": [
{
"email": "sam.rivera@example.com",
"first_name": "Sam",
"id": 29682885,
"is_active": true,
"last_name": "Rivera",
"mobile_phone": "",
"office_phone": "555-0110",
"resource_type": "Employee",
"title": "Service desk engineer",
"user_name": "srivera"
}
]
}Find tasks
Find project tasks by project, title, status or resource, oldest first.
Inputs
- Project
project_idtext - Only this project's tasks, by id.
- Title contains
title_containstext - Only tasks whose title has this text.
- Statuses
statuseslist - Only tasks in these statuses.
- Primary resource
assigned_resource_idtext - Only those assigned to this resource (user).
- Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
taskslist- The tasks, oldest first
Example output
{
"count": 1,
"has_more": false,
"tasks": [
{
"assigned_resource_id": null,
"assigned_role_id": null,
"completed_date_time": "",
"create_date_time": "2026-04-20T12:05:00Z",
"description": "",
"end_date_time": "2026-05-09T00:00:00Z",
"estimated_hours": 2.0,
"id": 7001,
"last_activity_date_time": "2026-04-20T12:05:00Z",
"phase_id": null,
"project_id": 2001,
"remaining_hours": 2.0,
"start_date_time": "2026-05-02T09:00:00Z",
"status": 1,
"status_label": "New",
"task_number": "T20260501.0003.001",
"task_type": 1,
"task_type_label": "Fixed Work",
"title": "Order network cabling",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenTaskDetail&TaskID=7001",
"user_defined_fields": {}
}
]
}Find tickets
Find tickets by number, title, company, contact, status, priority, queue, resource or date, oldest first.
Inputs
- Ticket number
ticket_numbertext - Only this ticket, such as T20240101.0001.
- Title contains
title_containstext - Only tickets whose title has this text.
- Company
company_idtext - Only this company's. Pick one, or give its id.
- Contact
contact_idtext - Only this contact's tickets, by id.
- Statuses
statuseslist - Only tickets in these statuses.
- Priorities
prioritieslist - Only tickets of these priorities.
- Queues
queue_idslist - Only tickets in these queues.
- Primary resource
assigned_resource_idtext - Only those assigned to this resource (user).
- Created on or after
created_afterdate and time - Only tickets created from then.
- Created on or before
created_beforedate and time - Only tickets created until then.
- Activity on or after
active_afterdate and time - Only tickets with activity (a change, note or time entry) from then.
- Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
ticketslist- The tickets, oldest first
Example output
{
"count": 1,
"has_more": false,
"tickets": [
{
"assigned_resource_id": 29682885,
"assigned_role_id": 29683461,
"company_id": 174,
"completed_date": "",
"configuration_item_id": null,
"contact_id": 30684512,
"contract_id": null,
"create_date": "2026-05-14T09:12:44Z",
"created_by_resource_id": 29682885,
"description": "The reception printer shows as offline for everyone.",
"due_date_time": "2026-05-15T17:00:00Z",
"estimated_hours": 1.5,
"external_id": "",
"first_response_date_time": "2026-05-14T09:30:00Z",
"id": 12345,
"issue_type": 4,
"issue_type_label": "Hardware",
"last_activity_date": "2026-05-14T10:03:10Z",
"priority": 2,
"priority_label": "Medium",
"project_id": null,
"purchase_order_number": "",
"queue": "Level I Support",
"queue_id": 29683354,
"resolution": "",
"resolved_date_time": "",
"source": 4,
"source_label": "Phone",
"status": 1,
"status_label": "New",
"sub_issue_type": 31,
"sub_issue_type_label": "Printer",
"ticket_category": 3,
"ticket_category_label": "Standard",
"ticket_number": "T20260514.0042",
"ticket_type": 1,
"ticket_type_label": "Service Request",
"title": "Printer offline in reception",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenTicketDetail&TicketID=12345",
"user_defined_fields": {
"Site": "Head office"
}
}
]
}Find time entries
Find time logged on a ticket or task, by a resource, or between two days, oldest first.
Inputs
- Ticket
ticket_idtext - Only time on this ticket (id or number).
- Task
task_idtext - Only time on this project task, by id.
- Resource
resource_idtext - Only this resource's time.
- Worked from
worked_fromdate - Only time worked on or after this day.
- Worked to
worked_todate - Only time worked on or before this day.
- Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
time_entrieslist- The time entries, oldest first
Example output
{
"count": 1,
"has_more": false,
"time_entries": [
{
"billing_code_id": 29682801,
"contract_id": null,
"create_date_time": "2026-05-14T10:05:00Z",
"date_worked": "2026-05-14T00:00:00Z",
"end_date_time": "",
"hours_to_bill": 0.5,
"hours_worked": 0.5,
"id": 51200,
"internal_notes": "",
"is_non_billable": false,
"last_modified_date_time": "2026-05-14T10:05:00Z",
"resource_id": 29682885,
"role_id": 29683461,
"start_date_time": "",
"summary_notes": "Restarted the print spooler.",
"task_id": null,
"ticket_id": 12345,
"time_entry_type": 2,
"time_entry_type_label": "Ticket"
}
]
}Get company
Get a company by its id, with its type, address and a link to open it.
Inputs
- Company
company_idtextRequired - The company (customer). Pick one, or give its id.
Outputs
companyobject- The company
Example output
{
"company": {
"address1": "12 High Street",
"address2": "",
"city": "Springfield",
"company_name": "Northwind Dental",
"company_number": "NWD-001",
"company_type": 1,
"company_type_label": "Customer",
"country_id": 237,
"create_date": "2024-02-01T15:20:00Z",
"id": 174,
"is_active": true,
"last_activity_date": "2026-05-14T10:03:10Z",
"owner_resource_id": 29682885,
"parent_company_id": null,
"phone": "555-0100",
"postal_code": "62701",
"state": "IL",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenAccount&AccountID=174",
"user_defined_fields": {
"Contract tier": "Gold"
},
"web_address": "https://northwind.example.com"
}
}Get ticket
Get a ticket by its id or ticket number, with its status, priority, queue and a link to open it.
Inputs
- Ticket
ticket_idtextRequired - The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
Outputs
ticketobject- The ticket
Example output
{
"ticket": {
"assigned_resource_id": 29682885,
"assigned_role_id": 29683461,
"company_id": 174,
"completed_date": "",
"configuration_item_id": null,
"contact_id": 30684512,
"contract_id": null,
"create_date": "2026-05-14T09:12:44Z",
"created_by_resource_id": 29682885,
"description": "The reception printer shows as offline for everyone.",
"due_date_time": "2026-05-15T17:00:00Z",
"estimated_hours": 1.5,
"external_id": "",
"first_response_date_time": "2026-05-14T09:30:00Z",
"id": 12345,
"issue_type": 4,
"issue_type_label": "Hardware",
"last_activity_date": "2026-05-14T10:03:10Z",
"priority": 2,
"priority_label": "Medium",
"project_id": null,
"purchase_order_number": "",
"queue": "Level I Support",
"queue_id": 29683354,
"resolution": "",
"resolved_date_time": "",
"source": 4,
"source_label": "Phone",
"status": 1,
"status_label": "New",
"sub_issue_type": 31,
"sub_issue_type_label": "Printer",
"ticket_category": 3,
"ticket_category_label": "Standard",
"ticket_number": "T20260514.0042",
"ticket_type": 1,
"ticket_type_label": "Service Request",
"title": "Printer offline in reception",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenTicketDetail&TicketID=12345",
"user_defined_fields": {
"Site": "Head office"
}
}
}List ticket notes
List a ticket's notes, oldest first.
Inputs
- Ticket
ticket_idtextRequired - The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
- Most to return
limitnumber - How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first.From 1 to 500.
Outputs
countnumber- How many are returned
has_moretrue/false- Whether more match than were returned (narrow the search, or raise the limit)
noteslist- The notes, oldest first
Example output
{
"count": 1,
"has_more": false,
"notes": [
{
"create_date_time": "2026-05-14T10:03:10Z",
"created_by_contact_id": null,
"created_by_resource_id": 29682885,
"description": "Restarted the print spooler; printer is back online.",
"id": 30199871,
"last_activity_date": "2026-05-14T10:03:10Z",
"note_type": 1,
"note_type_label": "Task Detail",
"publish": 1,
"publish_label": "All Autotask Users",
"ticket_id": 12345,
"title": "Called the customer"
}
]
}Log time
Log time a resource worked on a ticket or a project task. Give the hours, or a start and end time.
Inputs
- Resource
resource_idtextRequired - The resource (user) who did the work.
- Summary notes
summary_notestextRequired - What was done. Autotask requires it.
- Ticket
ticket_idtext - The ticket's id or number. Give a ticket or a task.
- Task
task_idtext - The project task's id. Give a ticket or a task.
- Role
role_idtext - The role the work was done in. Defaults to the resource's default service desk role.
- Day worked
date_workeddate - Defaults to today (UTC), or the start time's day.
- Start time
start_date_timedate and time - When the work started.
- End time
end_date_timedate and time - When the work ended.
- Hours worked
hours_workednumber - More than 0 and at most 24. Leave empty to count from the start and end times.From 0 to 24.
- Internal notes
internal_notestext - Notes only your team sees.
- Not billable
non_billabletrue/false - Don't bill the customer for this time.Default:
false.
Outputs
time_entryobject- The time entry
Example output
{
"time_entry": {
"billing_code_id": 29682801,
"contract_id": null,
"create_date_time": "2026-05-14T10:05:00Z",
"date_worked": "2026-05-14T00:00:00Z",
"end_date_time": "",
"hours_to_bill": 0.5,
"hours_worked": 0.5,
"id": 51200,
"internal_notes": "",
"is_non_billable": false,
"last_modified_date_time": "2026-05-14T10:05:00Z",
"resource_id": 29682885,
"role_id": 29683461,
"start_date_time": "",
"summary_notes": "Restarted the print spooler.",
"task_id": null,
"ticket_id": 12345,
"time_entry_type": 2,
"time_entry_type_label": "Ticket"
}
}Update company
Change a company's name, type, contact details or account manager, or make it inactive. Empty fields are left as they are.
Inputs
- Company
company_idtextRequired - The company (customer). Pick one, or give its id.
- Name
company_nametext - A new name.
- Type
company_typetext - Pick one, or give its id or name.
- Phone
phonetext - Phone number.
- Website
web_addresstext - The company's website.
- Address line 1
address1text - Street address.
- Address line 2
address2text - Second address line.
- City
citytext - City.
- State or region
statetext - State, county or region.
- Postal code
postal_codetext - ZIP or postal code.
- Account manager
owner_resource_idtext - The resource who owns the company. It must be a person, not an API user.
- Active or inactive
company_statustext - Make the company active or inactive.One of:
active,inactive. - User-defined fields
custom_fieldsobject - Values for the account's user-defined company fields.
Outputs
companyobject- The company
Example output
{
"company": {
"address1": "12 High Street",
"address2": "",
"city": "Springfield",
"company_name": "Northwind Dental",
"company_number": "NWD-001",
"company_type": 1,
"company_type_label": "Customer",
"country_id": 237,
"create_date": "2024-02-01T15:20:00Z",
"id": 174,
"is_active": true,
"last_activity_date": "2026-05-14T10:03:10Z",
"owner_resource_id": 29682885,
"parent_company_id": null,
"phone": "555-0100",
"postal_code": "62701",
"state": "IL",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenAccount&AccountID=174",
"user_defined_fields": {
"Contract tier": "Gold"
},
"web_address": "https://northwind.example.com"
}
}Update contact
Change a contact's name, email, phone or job title, or make them inactive. Empty fields are left as they are.
Inputs
- Contact
contact_idtextRequired - The contact's id.
- First name
first_nametext - A new first name.
- Last name
last_nametext - A new last name.
- Email
emailtext - Email address.
- Phone
phonetext - Phone number.
- Mobile phone
mobile_phonetext - Mobile number.
- Job title
titletext - Their job title.
- Active or inactive
contact_statustext - Make the contact active or inactive.One of:
active,inactive.
Outputs
contactobject- The contact
Example output
{
"contact": {
"city": "Springfield",
"company_id": 174,
"create_date": "2024-02-01T15:25:00Z",
"email": "ana.lopez@example.com",
"first_name": "Ana",
"id": 30684512,
"is_active": true,
"last_activity_date": "2026-05-14T09:12:44Z",
"last_modified_date": "2026-04-02T08:00:00Z",
"last_name": "Lopez",
"mobile_phone": "555-0199",
"phone": "555-0101",
"primary_contact": true,
"state": "IL",
"title": "Office manager",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenContact&ContactID=30684512",
"user_defined_fields": {},
"zip_code": "62701"
}
}Update project
Change a project's name, status (Complete completes its tasks too), end date, description or lead. Empty fields are left as they are.
Inputs
- Project
project_idtextRequired - The project's id.
- Name
project_nametext - A new name.
- Status
statustext - Pick one, or give its id or name, such as Complete.
- End date
end_datedate - A new end date.
- Description
descriptiontext - What it is about.
- Status notes
status_detailtext - Notes on the project's status.
- Project lead
project_lead_resource_idtext - The resource leading it.
Outputs
projectobject- The project
Example output
{
"project": {
"actual_hours": 4.0,
"company_id": 174,
"completed_date_time": "",
"completed_percentage": 10,
"create_date_time": "2026-04-20T12:00:00Z",
"description": "Move the practice to the new building.",
"end_date_time": "2026-06-30T00:00:00Z",
"estimated_time": 40.0,
"id": 2001,
"last_activity_date_time": "2026-05-10T16:00:00Z",
"project_lead_resource_id": 29682885,
"project_name": "Office move",
"project_number": "P20260501.0003",
"project_type": 5,
"project_type_label": "Client",
"start_date_time": "2026-05-01T00:00:00Z",
"status": 1,
"status_detail": "",
"status_label": "New",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenProject&ProjectID=2001",
"user_defined_fields": {}
}
}Update task
Change a project task's title, status (such as Complete), description, estimate or due date. Empty fields are left as they are.
Inputs
- Task
task_idtextRequired - The task's id.
- Title
titletext - A new title.
- Status
statustext - Pick one, or give its id or name, such as Complete.
- Description
descriptiontext - What it is about.
- Estimated hours
estimated_hoursnumber - Hours it should take.At least 0.
- Due date
end_datedate - When it is due.
Outputs
taskobject- The task
Example output
{
"task": {
"assigned_resource_id": null,
"assigned_role_id": null,
"completed_date_time": "",
"create_date_time": "2026-04-20T12:05:00Z",
"description": "",
"end_date_time": "2026-05-09T00:00:00Z",
"estimated_hours": 2.0,
"id": 7001,
"last_activity_date_time": "2026-04-20T12:05:00Z",
"phase_id": null,
"project_id": 2001,
"remaining_hours": 2.0,
"start_date_time": "2026-05-02T09:00:00Z",
"status": 1,
"status_label": "New",
"task_number": "T20260501.0003.001",
"task_type": 1,
"task_type_label": "Fixed Work",
"title": "Order network cabling",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenTaskDetail&TaskID=7001",
"user_defined_fields": {}
}
}Update ticket
Change a ticket: its status (such as Complete), priority, queue, due date, resource, resolution and other fields. Empty fields are left as they are.
Inputs
- Ticket
ticket_idtextRequired - The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
- Title
titletext - A new title.
- Description
descriptiontext - What it is about.
- Status
statustext - Pick one, or give its id or name, such as Complete.
- Priority
prioritytext - Pick one, or give its id or name.
- Queue
queue_idtext - The service desk queue. Pick one, or give its id or name.
- Due
due_date_timedate and time - When it is due.
- Issue type
issue_typetext - Pick one, or give its id or name.
- Sub-issue type
sub_issue_typetext - Pick one of the issue type's sub-issue types, or give its id or name.
- Ticket type
ticket_typetext - Service Request (Autotask's default), Incident, Problem or Change Request.
- Source
sourcetext - How the request came in, such as Phone or Email.
- Contact
contact_idtext - The contact's id. The contact must belong to the ticket's company.
- Primary resource
assigned_resource_idtext - The resource (user) to assign it to.
- Role
assigned_role_idtext - The role the resource works it in. Defaults to their default service desk role.
- Configuration item
configuration_item_idtext - The id of the device or other configuration item it is about.
- Estimated hours
estimated_hoursnumber - Hours it should take.At least 0.
- Resolution
resolutiontext - How it was resolved.
- User-defined fields
custom_fieldsobject - Values for the account's user-defined ticket fields.
Outputs
ticketobject- The ticket
Example output
{
"ticket": {
"assigned_resource_id": 29682885,
"assigned_role_id": 29683461,
"company_id": 174,
"completed_date": "",
"configuration_item_id": null,
"contact_id": 30684512,
"contract_id": null,
"create_date": "2026-05-14T09:12:44Z",
"created_by_resource_id": 29682885,
"description": "The reception printer shows as offline for everyone.",
"due_date_time": "2026-05-15T17:00:00Z",
"estimated_hours": 1.5,
"external_id": "",
"first_response_date_time": "2026-05-14T09:30:00Z",
"id": 12345,
"issue_type": 4,
"issue_type_label": "Hardware",
"last_activity_date": "2026-05-14T10:03:10Z",
"priority": 2,
"priority_label": "Medium",
"project_id": null,
"purchase_order_number": "",
"queue": "Level I Support",
"queue_id": 29683354,
"resolution": "",
"resolved_date_time": "",
"source": 4,
"source_label": "Phone",
"status": 1,
"status_label": "New",
"sub_issue_type": 31,
"sub_issue_type_label": "Printer",
"ticket_category": 3,
"ticket_category_label": "Standard",
"ticket_number": "T20260514.0042",
"ticket_type": 1,
"ticket_type_label": "Service Request",
"title": "Printer offline in reception",
"url": "https://ww3.autotask.net/Autotask/AutotaskExtend/ExecuteCommand.aspx?Code=OpenTicketDetail&TicketID=12345",
"user_defined_fields": {
"Site": "Head office"
}
}
}