# Datto Autotask PSA

> 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.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/autotask

## Actions

### 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_id`, text, required): The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
- Note (`description`, text, required): The text of the note (plain text, up to 32,000 characters).
- Title (`title`, text): A title. Some ticket categories require one.
- Note type (`note_type`, text): Pick one, or give its id or name.
- Who can see it (`publish`, text): All Autotask users, internal users only, and so on. Pick one, or give its id or name.

**Outputs**

- `note` (object): The note

**Example output**

```json
{
  "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_name`, text, required): The company's name.
- Phone (`phone`, text, required): The company's phone number. Autotask requires it.
- Account manager (`owner_resource_id`, text, required): The resource who owns the company. It must be a person, not an API user.
- Type (`company_type`, text): Customer, Lead, Prospect, Vendor and so on. Defaults to the account's default (Customer).
- Website (`web_address`, text): The company's website.
- Address line 1 (`address1`, text): Street address.
- Address line 2 (`address2`, text): Second address line.
- City (`city`, text): City.
- State or region (`state`, text): State, county or region.
- Postal code (`postal_code`, text): ZIP or postal code.
- User-defined fields (`custom_fields`, object): Values for the account's user-defined company fields.

**Outputs**

- `company` (object): The company

**Example output**

```json
{
  "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_id`, text, required): The company (customer). Pick one, or give its id.
- First name (`first_name`, text, required): The contact's first name.
- Last name (`last_name`, text, required): The contact's last name.
- Email (`email`, text): Email address.
- Phone (`phone`, text): Phone number.
- Mobile phone (`mobile_phone`, text): Mobile number.
- Job title (`title`, text): Their job title.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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_id`, text, required): The company (customer). Pick one, or give its id.
- Name (`project_name`, text, required): The project's name.
- End date (`end_date`, date, required): When the project should finish.
- Start date (`start_date`, date): When it starts. Defaults to today (UTC).
- Status (`status`, text): Pick one, or give its id or name. Defaults to the account's default.
- Type (`project_type`, text): Client, Internal, Proposal or Template. Defaults to the account's default.
- Description (`description`, text): What it is about.
- Project lead (`project_lead_resource_id`, text): The resource leading it.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The project's id.
- Title (`title`, text, required): What the task is.
- Status (`status`, text): Pick one, or give its id or name. Defaults to the account's default.
- Type (`task_type`, text): Fixed Work or Fixed Duration. Defaults to the account's default.
- Description (`description`, text): What it is about.
- Estimated hours (`estimated_hours`, number): Hours it should take. At least 0.
- Start (`start_date_time`, date and time): When work on it starts.
- Due date (`end_date`, date): When it is due.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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_id`, text, required): The company (customer). Pick one, or give its id.
- Title (`title`, text, required): A short summary of the request.
- Description (`description`, text): What it is about.
- Status (`status`, text): Pick one, or give its id or name. Defaults to the account's default (New).
- Priority (`priority`, text): Pick one, or give its id or name. Defaults to the account's default.
- Queue (`queue_id`, text): The service desk queue. Pick one, or give its id or name.
- Due (`due_date_time`, date and time): When it is due. Autotask needs one unless the ticket category sets a default due date.
- Issue type (`issue_type`, text): Pick one, or give its id or name.
- Sub-issue type (`sub_issue_type`, text): Pick one of the issue type's sub-issue types, or give its id or name.
- Ticket type (`ticket_type`, text): Service Request (Autotask's default), Incident, Problem or Change Request.
- Source (`source`, text): How the request came in, such as Phone or Email.
- Contact (`contact_id`, text): The contact's id. The contact must belong to the ticket's company.
- Primary resource (`assigned_resource_id`, text): The resource (user) to assign it to.
- Role (`assigned_role_id`, text): The role the resource works it in. Defaults to their default service desk role.
- Configuration item (`configuration_item_id`, text): The id of the device or other configuration item it is about.
- Estimated hours (`estimated_hours`, number): Hours it should take. At least 0.
- User-defined fields (`custom_fields`, object): Values for the account's user-defined ticket fields.

**Outputs**

- `ticket` (object): The ticket

**Example output**

```json
{
  "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_id`, text, required): The contact's id.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `id` (number): The id of what was deleted

**Example output**

```json
{
  "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_id`, text, required): The time entry's id, from 'Log time' or 'Find time entries'.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `id` (number): The id of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 51200
}
```

### Find companies

Find companies by name, type, phone or when they were added, oldest first.

**Inputs**

- Name contains (`name_contains`, text): Only companies whose name has this text.
- Types (`company_types`, list): Only companies of these types.
- Phone (`phone`, text): Only companies with exactly this phone number.
- Active or inactive (`active`, text): 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_after`, date and time): Only companies added from then.
- Most to return (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `companies` (list): The companies, oldest first
- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)

**Example output**

```json
{
  "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_id`, text): Only this company's. Pick one, or give its id.
- Name contains (`name_contains`, text): Only items whose name (reference title) has this text.
- Serial number (`serial_number`, text): Only the item with exactly this serial number.
- Types (`configuration_item_types`, list): Only items of these types.
- Active or inactive (`active`, text): 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 (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `configuration_items` (list): The configuration items, oldest first
- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)

**Example output**

```json
{
  "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 (`email`, text): Only the contact with exactly this email address.
- Name contains (`name_contains`, text): Only contacts whose first or last name has this text.
- Company (`company_id`, text): Only this company's. Pick one, or give its id.
- Active or inactive (`active`, text): 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 (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `contacts` (list): The contacts, oldest first
- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)

**Example output**

```json
{
  "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_contains`, text): Only projects whose name has this text.
- Company (`company_id`, text): Only this company's. Pick one, or give its id.
- Statuses (`statuses`, list): Only projects in these statuses.
- Types (`project_types`, list): Only projects of these types.
- Most to return (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)
- `projects` (list): The projects, oldest first

**Example output**

```json
{
  "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 (`search`, text): Only resources whose name or user name has this text.
- Email (`email`, text): Only the resource with exactly this email address.
- Active or inactive (`active`, text): 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 (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)
- `resources` (list): The resources, oldest first

**Example output**

```json
{
  "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_id`, text): Only this project's tasks, by id.
- Title contains (`title_contains`, text): Only tasks whose title has this text.
- Statuses (`statuses`, list): Only tasks in these statuses.
- Primary resource (`assigned_resource_id`, text): Only those assigned to this resource (user).
- Most to return (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)
- `tasks` (list): The tasks, oldest first

**Example output**

```json
{
  "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_number`, text): Only this ticket, such as T20240101.0001.
- Title contains (`title_contains`, text): Only tickets whose title has this text.
- Company (`company_id`, text): Only this company's. Pick one, or give its id.
- Contact (`contact_id`, text): Only this contact's tickets, by id.
- Statuses (`statuses`, list): Only tickets in these statuses.
- Priorities (`priorities`, list): Only tickets of these priorities.
- Queues (`queue_ids`, list): Only tickets in these queues.
- Primary resource (`assigned_resource_id`, text): Only those assigned to this resource (user).
- Created on or after (`created_after`, date and time): Only tickets created from then.
- Created on or before (`created_before`, date and time): Only tickets created until then.
- Activity on or after (`active_after`, date and time): Only tickets with activity (a change, note or time entry) from then.
- Most to return (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)
- `tickets` (list): The tickets, oldest first

**Example output**

```json
{
  "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_id`, text): Only time on this ticket (id or number).
- Task (`task_id`, text): Only time on this project task, by id.
- Resource (`resource_id`, text): Only this resource's time.
- Worked from (`worked_from`, date): Only time worked on or after this day.
- Worked to (`worked_to`, date): Only time worked on or before this day.
- Most to return (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)
- `time_entries` (list): The time entries, oldest first

**Example output**

```json
{
  "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_id`, text, required): The company (customer). Pick one, or give its id.

**Outputs**

- `company` (object): The company

**Example output**

```json
{
  "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_id`, text, required): The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.

**Outputs**

- `ticket` (object): The ticket

**Example output**

```json
{
  "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_id`, text, required): The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
- Most to return (`limit`, number): How many to return at most, 1 to 500. Defaults to 50. Autotask returns the oldest first. From 1 to 500.

**Outputs**

- `count` (number): How many are returned
- `has_more` (true/false): Whether more match than were returned (narrow the search, or raise the limit)
- `notes` (list): The notes, oldest first

**Example output**

```json
{
  "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_id`, text, required): The resource (user) who did the work.
- Summary notes (`summary_notes`, text, required): What was done. Autotask requires it.
- Ticket (`ticket_id`, text): The ticket's id or number. Give a ticket or a task.
- Task (`task_id`, text): The project task's id. Give a ticket or a task.
- Role (`role_id`, text): The role the work was done in. Defaults to the resource's default service desk role.
- Day worked (`date_worked`, date): Defaults to today (UTC), or the start time's day.
- Start time (`start_date_time`, date and time): When the work started.
- End time (`end_date_time`, date and time): When the work ended.
- Hours worked (`hours_worked`, number): More than 0 and at most 24. Leave empty to count from the start and end times. From 0 to 24.
- Internal notes (`internal_notes`, text): Notes only your team sees.
- Not billable (`non_billable`, true/false): Don't bill the customer for this time. Default: `false`.

**Outputs**

- `time_entry` (object): The time entry

**Example output**

```json
{
  "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_id`, text, required): The company (customer). Pick one, or give its id.
- Name (`company_name`, text): A new name.
- Type (`company_type`, text): Pick one, or give its id or name.
- Phone (`phone`, text): Phone number.
- Website (`web_address`, text): The company's website.
- Address line 1 (`address1`, text): Street address.
- Address line 2 (`address2`, text): Second address line.
- City (`city`, text): City.
- State or region (`state`, text): State, county or region.
- Postal code (`postal_code`, text): ZIP or postal code.
- Account manager (`owner_resource_id`, text): The resource who owns the company. It must be a person, not an API user.
- Active or inactive (`company_status`, text): Make the company active or inactive. One of: `active`, `inactive`.
- User-defined fields (`custom_fields`, object): Values for the account's user-defined company fields.

**Outputs**

- `company` (object): The company

**Example output**

```json
{
  "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_id`, text, required): The contact's id.
- First name (`first_name`, text): A new first name.
- Last name (`last_name`, text): A new last name.
- Email (`email`, text): Email address.
- Phone (`phone`, text): Phone number.
- Mobile phone (`mobile_phone`, text): Mobile number.
- Job title (`title`, text): Their job title.
- Active or inactive (`contact_status`, text): Make the contact active or inactive. One of: `active`, `inactive`.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "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_id`, text, required): The project's id.
- Name (`project_name`, text): A new name.
- Status (`status`, text): Pick one, or give its id or name, such as Complete.
- End date (`end_date`, date): A new end date.
- Description (`description`, text): What it is about.
- Status notes (`status_detail`, text): Notes on the project's status.
- Project lead (`project_lead_resource_id`, text): The resource leading it.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The task's id.
- Title (`title`, text): A new title.
- Status (`status`, text): Pick one, or give its id or name, such as Complete.
- Description (`description`, text): What it is about.
- Estimated hours (`estimated_hours`, number): Hours it should take. At least 0.
- Due date (`end_date`, date): When it is due.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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_id`, text, required): The ticket's id or ticket number (such as T20240101.0001), from Autotask, an earlier step or a trigger.
- Title (`title`, text): A new title.
- Description (`description`, text): What it is about.
- Status (`status`, text): Pick one, or give its id or name, such as Complete.
- Priority (`priority`, text): Pick one, or give its id or name.
- Queue (`queue_id`, text): The service desk queue. Pick one, or give its id or name.
- Due (`due_date_time`, date and time): When it is due.
- Issue type (`issue_type`, text): Pick one, or give its id or name.
- Sub-issue type (`sub_issue_type`, text): Pick one of the issue type's sub-issue types, or give its id or name.
- Ticket type (`ticket_type`, text): Service Request (Autotask's default), Incident, Problem or Change Request.
- Source (`source`, text): How the request came in, such as Phone or Email.
- Contact (`contact_id`, text): The contact's id. The contact must belong to the ticket's company.
- Primary resource (`assigned_resource_id`, text): The resource (user) to assign it to.
- Role (`assigned_role_id`, text): The role the resource works it in. Defaults to their default service desk role.
- Configuration item (`configuration_item_id`, text): The id of the device or other configuration item it is about.
- Estimated hours (`estimated_hours`, number): Hours it should take. At least 0.
- Resolution (`resolution`, text): How it was resolved.
- User-defined fields (`custom_fields`, object): Values for the account's user-defined ticket fields.

**Outputs**

- `ticket` (object): The ticket

**Example output**

```json
{
  "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"
    }
  }
}
```
