Skip to main content

Create ConnectWise Ticket

The Create ConnectWise Ticket action creates a new service ticket in ConnectWise Manage. It matches the sender's email address to an existing ConnectWise Contact and Company, then creates the ticket with the board, status, priority, and other classification details you specify.

Workflow Action

This is a workflow action. It accepts a contact email address and uses it to locate the matching ConnectWise Contact and Company before creating the ticket. You must supply the Service Board directly. 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 create new ConnectWise tickets from incoming human-generated emails
  • You want ConnectWise to associate the ticket with the correct company based on the sender's email address

Don't use this action for:

  • Updating existing tickets: Use Update ConnectWise Ticket instead.
  • Automated alert emails: System-generated emails from monitoring tools or automated systems are better handled with different actions.
  • Scheduled tasks: This action is designed for email-based workflows and is only available for Hosted Mailboxes and Pollers.

Common Pattern: Pairing with Update ConnectWise Ticket

This action is typically used together with Update ConnectWise Ticket in a two-step pattern:

  1. Update ConnectWise Ticket runs first and attempts to find an existing ticket
  2. If no ticket is found, Create ConnectWise Ticket runs next to create a new one

This pattern handles both replies to existing tickets and new support requests with a single rule:

Rule: "Process Support Email"
1. Update ConnectWise Ticket
- If ticket found: adds note, workflow stops (or continues based on your setting)
- If no ticket found: sets flag and continues to next action
2. Create ConnectWise Ticket
- Creates new ticket only if step 1 didn't find one

Configuration

Contact & Company Matching

FieldDescription
Contact Email AddressThe email address used to locate a matching ConnectWise Contact and Company. Default: {{email.from.address}}.
Default CompanyThe fallback Company when no matching Contact or domain is found. Required.

Basic Information

FieldDescription
SummaryThe ticket summary/title (max 100 characters). Supports template variables like {{email.subject}}.
Initial DescriptionThe initial ticket description, which appears in the first note. Supports template variables.

Classification

FieldDescription
Service BoardThe service board for the ticket. Required.
StatusThe initial ticket status. If not provided, uses the board's default status.
TypeThe service type. Options depend on the selected board.
Sub-TypeThe service sub-type. Options depend on the selected board and type.
ItemThe service item. Options depend on the selected board.
PriorityThe ticket priority level.
SourceThe ticket source (e.g., Email, Phone, Portal).

Severity & Impact

FieldDescription
SeverityThe severity level: Low, Medium, or High.
ImpactThe impact level: Low, Medium, or High.
Budget HoursThe budgeted hours for this ticket.

Workflow Controls

FieldDescription
After Creating TicketWhat to do after the ticket is created successfully. Default: Stop All. Options: Continue, Stop, Stop All.
Error HandlingWhat to do if ticket creation fails. Options: Exception, Bounce, Continue, Stop, Stop All.

Connection

FieldDescription
ConnectWise ConnectionSelect the ConnectWise connection to use. Required.

Returned Variables

When you configure Store the results in Variable, these variables become available for use in subsequent actions:

Status Flags

VariableTypeDescription
LocatedExistingContactbooltrue if a matching Contact was found for the sender's email
LocatedExistingCompanybooltrue if a matching Company was found
UsedDefaultCompanybooltrue if the ticket was assigned to the Default Company
CreatedNewTicketbooltrue if the ticket was created successfully
CreatedNewTicketCausedErrorbooltrue if ticket creation failed
ContactEmailAddressstringThe email address used for matching
CompanyDomainstringThe domain portion of the contact email

Created Objects

VariableTypeDescription
TicketobjectThe created ConnectWise ticket
ContactobjectThe matched Contact (if found)
CompanyobjectThe matched or default Company

Example usage: {{custom.myVariable.Ticket.id}} or {{custom.myVariable.Ticket.summary}}

Ticket Properties

PropertyTypeDescription
idintThe ticket ID
summarystringThe ticket summary
boardobjectThe service board (id, name)
statusobjectThe ticket status (id, name)
companyobjectThe associated company (id, identifier, name)
contactobjectThe associated contact (id, name)

FAQs

What fields are required?

At minimum, you must provide:

  • ConnectWise Connection
  • Default Company
  • Summary
  • Service Board

All other fields are optional and will use defaults if not specified.

How do I use template variables?

The Summary and Initial Description fields support text expressions. Common examples:

  • {{email.subject}}: The email subject line
  • {{email.from.address}}: The sender's email address
  • {{email.from.display}}: The sender's display name
  • {{email.body}}: The full email body

What happens if ticket creation fails?

The behavior depends on your Error Handling setting:

SettingBehavior
ExceptionStop processing and report the error
BounceReturn the email to the sender
ContinueContinue to the next action
StopStop this rule but allow other rules to process
Stop AllStop all processing for this message