Back to documentation
Automation & AI1 min readUpdated 2026-04-16

Actions reference

Complete reference for every automation action type — what it does, how to configure it, and what each field means.

Communication

ActionWhat it doesKey fields
Send emailSends an email to the client or a custom recipientAudience (client contact / custom), subject, body. Supports @variables.
AI-composed emailClaude writes a unique email using real-time contextAudience, subject, tone (friendly/professional/firm/direct), goal prompt. 5 credits.
In-app notificationCreates a notification in Ratio's notification bellAudience (admins/all members/specific user), message body.

Billing

ActionWhat it doesKey fields
Apply late feeAdds a late fee line item to an overdue invoiceFee mode (fixed/percentage), amount, apply to (outstanding/total).
Escalate contactEscalates to a supervisor or alternate billing contactRecipient email, priority level, notes. Can also update client priority.

Team & approvals

ActionWhat it doesKey fields
Alert teamSends an internal alert to admins and managersInternal note with @variable support.
Assign to userAssigns the record to a team member or round-robinEntity type, assignment mode, target user or candidate pool.
Wait for approvalPauses the automation until someone approves or rejectsApprover (internal user). Creates an approval alert.
Flag for reviewEscalates to manual review — automation stops hereReview notes for the team.

Data & records

ActionWhat it doesKey fields
Create recordCreates a task or note on the record timelineRecord type (task/note), entity type, title, body, due date.
Add tagAttaches a tag to the record (auto-creates if new)Entity type, tag name.
Remove tagRemoves a tag from the recordEntity type, tag name.
Update record fieldSets a field value on a recordEntity type (client/project/invoice/lead), field name, value. Supports @variables.
Log activityCreates a visible timeline entryEntity type, activity message with @variable support.

Integrations

ActionWhat it doesKey fields
Wait / DelayPauses for a duration before the next actionDelay presets (30min–7 days) or custom hours.
Send webhookCalls an external URL or APIMethod (POST/GET/PUT/PATCH), URL, headers, body. Blocked for internal IPs.
Run another automationHands off to a different workflow templateTarget workflow slug. Useful for modular escalation chains.

AI-powered actions

AI actions use Claude to generate content or make decisions. Each action consumes included monthly credits first, then rollover credits if available. All AI prompts are validated before saving to ensure they stay on-task.

ActionCreditsWhat it doesKey fields
AI-composed email5Writes a unique contextual emailAudience, subject, tone, goal/prompt describing the email's purpose.
AI classify and route5Labels a record for downstream branchingLabels (one per line), output key, classification goal.
AI summarize and notify3Generates a digest and delivers to teamSubject, audience, summary goal.
AI draft proposal content10Drafts proposal copy with line itemsGoal describing the proposal direction. Requires proposal in context.
AI task list5Creates prioritized tasks from contextTask count, entity type, task creation goal.
AI enrich record3Writes insight notes to a record fieldEntity type, target field, write mode (append/replace), enrichment goal.
AI scheduling suggestion3Recommends optimal send timingLookback days, scheduling goal.

AI credit costs

Credit costs are shown on each AI action card in the builder. The total cost per run appears as a banner at the bottom of the timeline. Manage your credits in Settings → AI Credits.

Complete variable reference

These variables can be used in email subjects, email bodies, notification messages, and any text field that shows the @variable picker.

VariableDescriptionAvailable when
@clientContactNameClient primary contact full nameAny trigger with client context
@clientFirstNameClient contact first name onlyAny trigger with client context
@clientBusinessNameClient company or business nameAny trigger with client context
@clientEmailClient primary email addressAny trigger with client context
@businessNameYour workspace business nameAlways
@invoiceNumberInvoice number (e.g. INV-001)Invoice triggers
@invoiceAmountInvoice total as currencyInvoice triggers
@outstandingAmountRemaining balance as currencyInvoice triggers
@dueDateInvoice due dateInvoice triggers
@daysOverdueNumber of days past dueInvoice triggers
@projectNameProject nameProject/milestone triggers
@projectStatusCurrent project statusProject triggers
@proposalTitleProposal titleProposal triggers
@proposalAmountProposal total as currencyProposal triggers
@leadNameLead full nameLead triggers
@leadEmailLead email addressLead triggers
@leadSourceLead source (referral, website, etc.)Lead triggers
@leadStageCurrent pipeline stageLead triggers
@leadEstimatedValueDeal value estimateLead triggers
@appointmentTitleAppointment titleAppointment triggers
@appointmentDateAppointment dateAppointment triggers
@aiClassificationLabel from AI classify actionAfter AI classify action runs
@aiSummarySummary from AI summarize actionAfter AI summarize action runs
@aiRecommendationRecommendation from AI actionAfter any AI action with recommendation