Itsy Docs
Actions

Actions

Automate email notifications triggered by order events, payment milestones, schedules, or manual execution.

Actions automate email communications in your workspace. You define what triggers an email, who receives it, what it says, and what attachments to include. Instead of manually sending confirmation emails or payment reminders, actions handle these communications automatically whenever their conditions are met.

How It Works

Each action is an email template paired with one or more triggers. When a trigger fires — whether from a system event, a schedule, or a manual click — Itsy evaluates any conditions you have set. If the conditions pass, the email is rendered with order data, sent to the configured recipients, and the delivery is tracked through to inbox arrival.

Key Concepts

Action Properties

Each action has these core properties:

PropertyDescription
NameInternal name for the action
CodeA short identifier code
SubjectThe email subject line (supports template variables)
Sender NameThe display name shown as the email sender
Sender AddressThe email address it's sent from (defaults to workspace sender if empty)
Recipient TypeWho receives the email (see below)
CC / BCCAdditional email addresses to copy
ContentThe email body, built with a rich text editor
AttachmentsFiles to include with the email
ActiveWhether the action is currently enabled

Trigger Types

Each action can have multiple triggers. There are three types:

TypeDescription
EventFires automatically when a specific system event happens (e.g., an order is confirmed or a payment is received)
ScheduleRuns on a daily schedule, evaluating all orders against the trigger's conditions
ManualOnly fires when you explicitly run it from the order page

An action can have any combination of triggers — for example, you might have an action that fires both on the "Order Confirmed" event and can also be triggered manually from the order menu.

Available Events

Event triggers respond to 15 different system events:

CategoryEvents
OrderOrder Created Internally, Order Created Externally, Order Confirmed, Order Cancelled
PaymentPayment Deposit Reached, Payment Fully Paid, Payment Validated from External Service
InvoiceInvoice Created
NotificationNotification Delivered, Notification Failed, Notification Bounced, Notification Opened
GroupGroup Message Created, Group Message Updated
Gift CertificateGift Certificate Created

Manual Trigger Placements

When you create a manual trigger, you choose where the trigger button appears in the admin interface:

PlacementDescription
Order Item OverviewAppears as a quick action button on the order detail page
Order Top MenuAppears in the top menu of any order page
Invoice List MenuAppears in the invoice list actions menu

Trigger Conditions

Conditions let you control exactly when a trigger fires. Each condition checks an order property against a value using a comparison operator.

Condition fields:

FieldDescription
Order StatusThe current status of the order (Draft, Pending, Confirmed, Cancelled)
Total PriceThe order's total price
Total PaidThe amount paid so far
BalanceThe remaining amount owed (Total Price minus Total Paid)
Order CreatedDays since the order was created
Start DateDays relative to the trip departure date
End DateDays relative to the trip return date
Fully Paid DateDays since the order was fully paid

Comparison operators:

OperatorDescription
Is equalMust match exactly
Is not equalMust not match
Is larger thanMust exceed the value
Is smaller thanMust be less than the value

For date conditions, the value represents a number of days relative to today. For example, setting "Start Date is equal to -7" matches orders whose trip starts 7 days from now.

All conditions on a trigger must be satisfied for the trigger to fire (they are combined with AND logic).

Email Recipients

Recipient TypeDescription
Order ClientThe customer who placed the order. For corporate clients, Itsy routes to the appropriate contact based on context (invoice contacts for invoice-related actions, payment contacts for payment actions).
Workspace AdminThe workspace's administrator email address
Group ContactThe contact person for a group booking (falls back to the order client if none)
Custom EmailA specific email address you enter

You can also add CC and BCC recipients to any action.

Email Content

The email body is built with a rich text editor that supports headings, paragraphs, bold, and italic formatting. You can insert special content blocks that are automatically populated with order data:

BlockDescription
Order CodeDisplays the order reference number prominently
Client InformationShows the customer's name, email, phone, and address
Order InformationShows trip name, participants, booking date, departure date, total price, balance, and bookings
Trip InformationShows the trip name and departure date
Link to OverviewA button linking to the customer's order overview page
Link to PaymentsA button linking to the customer's payment page
Link to ParticipantsA button linking to the participant information page

You can also use template variables in both the subject line and body:

VariableReplaced With
{{orderCode}}The order reference code
{{workspace}}The workspace name
{{group}}The group name (in subject)
{{clientName}}The customer's full name
{{clientEmail}}The customer's email address
{{invoiceNumber}}The invoice number (when an invoice is attached)
{{invoiceDate}}The invoice date
{{invoiceAmount}}The invoice amount with currency
{{invoiceFiscalSequence}}The invoice fiscal sequence number

Emails are rendered in the workspace's configured language (English or Icelandic).

Email Attachments

You can attach files to action emails:

Attachment TypeDescription
Booking AttachmentsDocuments attached to individual bookings within the order
Order Overview PDFThe order overview document
Selected Invoice PDFThe PDF of a specific invoice
External AttachmentsFiles uploaded to the order, bookings, or participants (capped at 20 MB total)

Managed Actions

Itsy provides pre-built managed actions for essential workspace operations. These handle common scenarios that every workspace needs:

  • Order Overview — Sends when orders need their overview document
  • Payment Receipt — Sends after payment validation
  • Payment Reminder — Runs on a daily schedule, sending reminders to customers with outstanding balances
  • Supplier Report — Delivers supplier reports

Managed actions differ from regular actions in important ways:

  • You cannot delete them
  • You cannot change the name, code, recipient type, or attachments
  • You can customize the email subject, body, sender details, CC/BCC, and active status

Action Templates

When creating a new action, you can start from a pre-built template instead of building from scratch:

TemplateWhat It Sets Up
BlankAn empty action with no pre-configured triggers
Order ConfirmationPre-configured with triggers for both internal and external order creation events
Payment ConfirmationPre-configured with a trigger for payment validation events
Payment ReminderPre-configured with a daily schedule trigger and conditions for orders with outstanding balance that aren't draft or cancelled

Templates save time by setting up the trigger, conditions, and a starting email template automatically.

Delivery Tracking

After an action sends an email, Itsy tracks its journey through the email delivery system:

StatusDescription
SubmittedThe email has been sent to the delivery provider
DeliveredThe email reached the recipient's inbox
BouncedThe email failed to deliver (invalid address, full inbox, etc.)
ErrorThe email could not be sent at all
OpenedThe recipient opened the email (tracked when possible)

Each delivery records the sender address, recipient address, timestamps, and any error details. The delivery is also logged on the order's timeline for audit purposes.

Deliveries Report

The deliveries report gives you a workspace-wide view of all email deliveries across all actions. You can filter by:

  • Specific actions — View deliveries for one or more actions
  • Date range — Filter to a specific time period

The report shows up to 1,000 delivery records, sorted by most recent first.

Common Tasks

Creating a New Action

  1. Navigate to the Actions section
  2. Click Add
  3. Choose a template (Blank, Order Confirmation, Payment Confirmation, or Payment Reminder)
  4. Enter the action name and code
  5. Configure the email subject, sender, and recipient
  6. Build the email content using the rich text editor
  7. Select any attachments to include
  8. Add triggers to control when the action fires
  9. Activate the action

Adding Triggers to an Action

  1. Open an action and go to the Triggers tab
  2. Enable the trigger type you want:
    • For Manual, choose where the button appears (Order Item Overview, Order Top Menu, or Invoice List Menu)
    • For Schedule, the action runs daily at 02:00
    • For Event, select the specific event to listen for
  3. Optionally add conditions to filter when the trigger fires
  4. Save your changes

Setting Up Payment Reminders

  1. Create an action using the Payment Reminder template
  2. The template automatically sets up:
    • A daily schedule trigger
    • Conditions: balance is larger than 0, status is not Draft, status is not Cancelled
  3. Customize the email subject and body
  4. Set the recipient to Order Client
  5. Activate the action

Running a Manual Action

  1. Open an order
  2. Depending on the manual trigger's placement, find the action button in:
    • The quick actions on the order overview
    • The top menu of the order page
    • The invoice list actions menu
  3. Click the action to send the email immediately

Reviewing Delivery History

  1. To see deliveries for a specific action: open the action and go to the Deliveries tab
  2. To see all deliveries across your workspace: go to the Deliveries report under Actions
  3. Filter by action or date range as needed
  4. Click on a delivery to see its full event log (submitted, delivered, opened, bounced)

Customizing a Managed Action

  1. Go to Settings and find Managed Emails
  2. Select the managed action to customize (Order Overview, Payment Reminder, Payment Receipt, or Supplier Report)
  3. Edit the email subject and body
  4. Update sender details and CC/BCC if needed
  5. Save your changes

How It Connects

  • Orders — Most action triggers are based on order events. Deliveries are logged on the order timeline and can be viewed per client.
  • Groups — Group message events can trigger notifications. The Group Contact recipient type sends to the group's contact person.
  • Gift Certificates — Gift certificate creation can trigger delivery emails.
  • Clients — Corporate clients can have contacts with specific notification preferences (invoices, payment receipts, order confirmations), and actions route emails to the appropriate contacts automatically.

On this page