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

ActionWhat it does
Add ticket noteAdd a note to a ticket.
Create companyAdd a company (a customer, lead, prospect or vendor).
Create contactAdd a contact (a person at a customer) to a company.
Create projectStart a project for a company.
Create taskAdd a task to a project.
Create ticketOpen a service desk ticket for a company.
Delete contactDelete a contact.
Delete time entryDelete a time entry that isn't on a submitted timesheet or posted yet.
Find companiesFind companies by name, type, phone or when they were added, oldest first.
Find configuration itemsFind a company's devices and other configuration items by name, serial number or type, oldest first.
Find contactsFind contacts by email, name or company, oldest first.
Find projectsFind projects by name, company, status or type, oldest first.
Find resourcesFind Autotask users (resources) by name or email, for their ids.
Find tasksFind project tasks by project, title, status or resource, oldest first.
Find ticketsFind tickets by number, title, company, contact, status, priority, queue, resource or date, oldest first.
Find time entriesFind time logged on a ticket or task, by a resource, or between two days, oldest first.
Get companyGet a company by its id, with its type, address and a link to open it.
Get ticketGet a ticket by its id or ticket number, with its status, priority, queue and a link to open it.
List ticket notesList a ticket's notes, oldest first.
Log timeLog time a resource worked on a ticket or a project task.
Update companyChange a company's name, type, contact details or account manager, or make it inactive.
Update contactChange a contact's name, email, phone or job title, or make them inactive.
Update projectChange a project's name, status (Complete completes its tasks too), end date, description or lead.
Update taskChange a project task's title, status (such as Complete), description, estimate or due date.
Update ticketChange 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

Ticketticket_idtextRequired
The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
NotedescriptiontextRequired
The text of the note (plain text, up to 32,000 characters).
Titletitletext
A title. Some ticket categories require one.
Note typenote_typetext
Pick one, or give its id or name.
Who can see itpublishtext
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

Namecompany_nametextRequired
The company's name.
PhonephonetextRequired
The company's phone number. Autotask requires it.
Account managerowner_resource_idtextRequired
The resource who owns the company. It must be a person, not an API user.
Typecompany_typetext
Customer, Lead, Prospect, Vendor and so on. Defaults to the account's default (Customer).
Websiteweb_addresstext
The company's website.
Address line 1address1text
Street address.
Address line 2address2text
Second address line.
Citycitytext
City.
State or regionstatetext
State, county or region.
Postal codepostal_codetext
ZIP or postal code.
User-defined fieldscustom_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

Companycompany_idtextRequired
The company (customer). Pick one, or give its id.
First namefirst_nametextRequired
The contact's first name.
Last namelast_nametextRequired
The contact's last name.
Emailemailtext
Email address.
Phonephonetext
Phone number.
Mobile phonemobile_phonetext
Mobile number.
Job titletitletext
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

Companycompany_idtextRequired
The company (customer). Pick one, or give its id.
Nameproject_nametextRequired
The project's name.
End dateend_datedateRequired
When the project should finish.
Start datestart_datedate
When it starts. Defaults to today (UTC).
Statusstatustext
Pick one, or give its id or name. Defaults to the account's default.
Typeproject_typetext
Client, Internal, Proposal or Template. Defaults to the account's default.
Descriptiondescriptiontext
What it is about.
Project leadproject_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

Projectproject_idtextRequired
The project's id.
TitletitletextRequired
What the task is.
Statusstatustext
Pick one, or give its id or name. Defaults to the account's default.
Typetask_typetext
Fixed Work or Fixed Duration. Defaults to the account's default.
Descriptiondescriptiontext
What it is about.
Estimated hoursestimated_hoursnumber
Hours it should take.At least 0.
Startstart_date_timedate and time
When work on it starts.
Due dateend_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

Companycompany_idtextRequired
The company (customer). Pick one, or give its id.
TitletitletextRequired
A short summary of the request.
Descriptiondescriptiontext
What it is about.
Statusstatustext
Pick one, or give its id or name. Defaults to the account's default (New).
Priorityprioritytext
Pick one, or give its id or name. Defaults to the account's default.
Queuequeue_idtext
The service desk queue. Pick one, or give its id or name.
Duedue_date_timedate and time
When it is due. Autotask needs one unless the ticket category sets a default due date.
Issue typeissue_typetext
Pick one, or give its id or name.
Sub-issue typesub_issue_typetext
Pick one of the issue type's sub-issue types, or give its id or name.
Ticket typeticket_typetext
Service Request (Autotask's default), Incident, Problem or Change Request.
Sourcesourcetext
How the request came in, such as Phone or Email.
Contactcontact_idtext
The contact's id. The contact must belong to the ticket's company.
Primary resourceassigned_resource_idtext
The resource (user) to assign it to.
Roleassigned_role_idtext
The role the resource works it in. Defaults to their default service desk role.
Configuration itemconfiguration_item_idtext
The id of the device or other configuration item it is about.
Estimated hoursestimated_hoursnumber
Hours it should take.At least 0.
User-defined fieldscustom_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

Contactcontact_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 entrytime_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 containsname_containstext
Only companies whose name has this text.
Typescompany_typeslist
Only companies of these types.
Phonephonetext
Only companies with exactly this phone number.
Active or inactiveactivetext
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 aftercreated_afterdate and time
Only companies added from then.
Most to returnlimitnumber
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

Companycompany_idtext
Only this company's. Pick one, or give its id.
Name containsname_containstext
Only items whose name (reference title) has this text.
Serial numberserial_numbertext
Only the item with exactly this serial number.
Typesconfiguration_item_typeslist
Only items of these types.
Active or inactiveactivetext
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 returnlimitnumber
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

Emailemailtext
Only the contact with exactly this email address.
Name containsname_containstext
Only contacts whose first or last name has this text.
Companycompany_idtext
Only this company's. Pick one, or give its id.
Active or inactiveactivetext
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 returnlimitnumber
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 containsname_containstext
Only projects whose name has this text.
Companycompany_idtext
Only this company's. Pick one, or give its id.
Statusesstatuseslist
Only projects in these statuses.
Typesproject_typeslist
Only projects of these types.
Most to returnlimitnumber
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 containssearchtext
Only resources whose name or user name has this text.
Emailemailtext
Only the resource with exactly this email address.
Active or inactiveactivetext
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 returnlimitnumber
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

Projectproject_idtext
Only this project's tasks, by id.
Title containstitle_containstext
Only tasks whose title has this text.
Statusesstatuseslist
Only tasks in these statuses.
Primary resourceassigned_resource_idtext
Only those assigned to this resource (user).
Most to returnlimitnumber
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 numberticket_numbertext
Only this ticket, such as T20240101.0001.
Title containstitle_containstext
Only tickets whose title has this text.
Companycompany_idtext
Only this company's. Pick one, or give its id.
Contactcontact_idtext
Only this contact's tickets, by id.
Statusesstatuseslist
Only tickets in these statuses.
Prioritiesprioritieslist
Only tickets of these priorities.
Queuesqueue_idslist
Only tickets in these queues.
Primary resourceassigned_resource_idtext
Only those assigned to this resource (user).
Created on or aftercreated_afterdate and time
Only tickets created from then.
Created on or beforecreated_beforedate and time
Only tickets created until then.
Activity on or afteractive_afterdate and time
Only tickets with activity (a change, note or time entry) from then.
Most to returnlimitnumber
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

Ticketticket_idtext
Only time on this ticket (id or number).
Tasktask_idtext
Only time on this project task, by id.
Resourceresource_idtext
Only this resource's time.
Worked fromworked_fromdate
Only time worked on or after this day.
Worked toworked_todate
Only time worked on or before this day.
Most to returnlimitnumber
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

Companycompany_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

Ticketticket_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

Ticketticket_idtextRequired
The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
Most to returnlimitnumber
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

Resourceresource_idtextRequired
The resource (user) who did the work.
Summary notessummary_notestextRequired
What was done. Autotask requires it.
Ticketticket_idtext
The ticket's id or number. Give a ticket or a task.
Tasktask_idtext
The project task's id. Give a ticket or a task.
Rolerole_idtext
The role the work was done in. Defaults to the resource's default service desk role.
Day workeddate_workeddate
Defaults to today (UTC), or the start time's day.
Start timestart_date_timedate and time
When the work started.
End timeend_date_timedate and time
When the work ended.
Hours workedhours_workednumber
More than 0 and at most 24. Leave empty to count from the start and end times.From 0 to 24.
Internal notesinternal_notestext
Notes only your team sees.
Not billablenon_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

Companycompany_idtextRequired
The company (customer). Pick one, or give its id.
Namecompany_nametext
A new name.
Typecompany_typetext
Pick one, or give its id or name.
Phonephonetext
Phone number.
Websiteweb_addresstext
The company's website.
Address line 1address1text
Street address.
Address line 2address2text
Second address line.
Citycitytext
City.
State or regionstatetext
State, county or region.
Postal codepostal_codetext
ZIP or postal code.
Account managerowner_resource_idtext
The resource who owns the company. It must be a person, not an API user.
Active or inactivecompany_statustext
Make the company active or inactive.One of: active, inactive.
User-defined fieldscustom_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

Contactcontact_idtextRequired
The contact's id.
First namefirst_nametext
A new first name.
Last namelast_nametext
A new last name.
Emailemailtext
Email address.
Phonephonetext
Phone number.
Mobile phonemobile_phonetext
Mobile number.
Job titletitletext
Their job title.
Active or inactivecontact_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

Projectproject_idtextRequired
The project's id.
Nameproject_nametext
A new name.
Statusstatustext
Pick one, or give its id or name, such as Complete.
End dateend_datedate
A new end date.
Descriptiondescriptiontext
What it is about.
Status notesstatus_detailtext
Notes on the project's status.
Project leadproject_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

Tasktask_idtextRequired
The task's id.
Titletitletext
A new title.
Statusstatustext
Pick one, or give its id or name, such as Complete.
Descriptiondescriptiontext
What it is about.
Estimated hoursestimated_hoursnumber
Hours it should take.At least 0.
Due dateend_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

Ticketticket_idtextRequired
The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
Titletitletext
A new title.
Descriptiondescriptiontext
What it is about.
Statusstatustext
Pick one, or give its id or name, such as Complete.
Priorityprioritytext
Pick one, or give its id or name.
Queuequeue_idtext
The service desk queue. Pick one, or give its id or name.
Duedue_date_timedate and time
When it is due.
Issue typeissue_typetext
Pick one, or give its id or name.
Sub-issue typesub_issue_typetext
Pick one of the issue type's sub-issue types, or give its id or name.
Ticket typeticket_typetext
Service Request (Autotask's default), Incident, Problem or Change Request.
Sourcesourcetext
How the request came in, such as Phone or Email.
Contactcontact_idtext
The contact's id. The contact must belong to the ticket's company.
Primary resourceassigned_resource_idtext
The resource (user) to assign it to.
Roleassigned_role_idtext
The role the resource works it in. Defaults to their default service desk role.
Configuration itemconfiguration_item_idtext
The id of the device or other configuration item it is about.
Estimated hoursestimated_hoursnumber
Hours it should take.At least 0.
Resolutionresolutiontext
How it was resolved.
User-defined fieldscustom_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"
    }
  }
}

On this page