Create Autotask Time Entry
The Create Autotask Time Entry action creates a time entry on an existing Autotask ticket. It automatically locates the ticket from the email, matches the technician by email address, and logs time against the ticket.
This is a workflow action. It searches for the matching Autotask resource and ticket automatically, then creates the time entry. If you already have the ticket ID and resource ID, use API: Create an Object with the TimeEntry entity for direct control. Learn more about the difference between workflow actions and single API call actions.
When to Use This Action
Use this action when:
- You want to log time against tickets based on incoming emails from technicians
- You need to track time spent on email-based ticket correspondence
- Technicians send emails that should automatically create time entries
Don't use this action for:
- Creating tickets: Use Create Autotask Ticket instead.
- Adding notes without time: Use Update Existing Autotask Ticket instead.
- Fine-grained control: If you already have the ticket ID and need full control over time entry fields, use API: Create an Object with the TimeEntry entity.
- Task time entries: This action only works with tickets, not project tasks.
How It Works
This action operates in three phases:
Phase 1: Find the Resource
- Look up technician: Search Autotask for a resource (technician) matching the configured email address
- If no resource is found, the action uses the configured error handling
Phase 2: Find the Ticket
- Search for a ticket number: Scan configured fields (subject, body, etc.) for an Autotask ticket number
- Follow merged tickets (optional): If the ticket was merged, follow the chain to the final ticket
- If no ticket is found, the action uses the configured error handling
Phase 3: Create the Time Entry
- Create time entry: Log the specified duration against the ticket, attributed to the matched resource
- Calculate times: Set EndDateTime to the current time, and StartDateTime based on the duration
- Update status (optional): Change the ticket status if configured
- Attach files (optional): Add email attachments and/or .eml file to the ticket
Configuration
Search For Autotask Resource
| Field | Description | Default |
|---|---|---|
| Resource Email Address | Email address to match the Autotask resource who will be assigned to the time entry. Supports text expressions. | {{email.from.address}} |
| Action If No Resource Matched | What happens if no matching resource is found for the email address. | Exception |
Search for Autotask Ticket
| Field | Description | Default |
|---|---|---|
| Fields to Search for Ticket Number | Select which email fields to search for the Autotask ticket number. | Email subject |
| Follow Trail of Merged Tickets | If the matched ticket has been merged, follow the merge trail to find the current ticket. | Enabled |
| Action If No Ticket Matched | What happens if no matching ticket is found. | Exception |
Time Entry
| Field | Description | Default |
|---|---|---|
| Time Worked | Duration of work in minutes. Supports text expressions. The action sets EndDateTime to the current time and calculates StartDateTime based on this value. | 1 minute |
| Time Entry Fields | Configure time entry properties including Summary Notes, Internal Notes, Allocation Code, and Role. | Email body as summary |
| Set Ticket Status After Update | Optionally update the ticket status after adding the time entry. Leave empty to keep the current status. | None |
Attachments
| Field | Description |
|---|---|
| Attach email attachments to ticket | Creates an Autotask attachment for each file attached to the email. |
| Prevent duplicate attachments | Ensures each file is attached only once per ticket. |
| Attach original email as .eml file | Attaches the complete original email as an .eml file. |
| Attach HTML email as image | Converts the HTML email content to an image attachment. |
Advanced
| Field | Description |
|---|---|
| Suppress Autotask API exceptions | If enabled, the workflow continues even if the Autotask API returns an error. Use sparingly. |
| Override Autotask Connection | Use a specific Autotask connection instead of the default. |
Additional Options
| Field | Description | Default |
|---|---|---|
| Action After Success | What happens after successfully creating the time entry. | Stop All |
Returned Variables
When you configure Store the results in Variable, these variables become available for use in subsequent actions:
Retrieved Objects
| Variable | Type | Description |
|---|---|---|
Ticket | object | The matched Autotask ticket, including id and TicketNumber properties |
TimeEntry | object | The created time entry entity |
Example usage: {{custom.myVariable.TimeEntry.id}}
FAQs
How does the action calculate start and end times?
The action sets EndDateTime to the current time and calculates StartDateTime by subtracting the configured duration. For example, if you configure 15 minutes, the time entry shows as starting 15 minutes ago and ending now.
What role is assigned to the time entry?
The time entry uses the resource's default Service Desk role unless you specify a different role in the Time Entry Fields configuration.
Can I use a dynamic value for the time worked?
Yes. You can use text expressions like {{custom.parsedDuration}} if you have parsed the duration from the email content in a previous action.
What happens if the technician's email doesn't match any Autotask resource?
The action uses the configured Action If No Resource Matched setting. By default, this is set to Exception, which stops the workflow with an error. You can change this to Continue to allow subsequent actions to run.