Using Token Variables
To access the variable for a value field, simply type the @ symbol in the field.
A list of available variable tokens will then be displayed to select from.
Default Variables
By default, there are three variables available in every automation:
Current Date [ @{int:current-date} ]
This variable prints the current date.
Current Date & Time [ @{int:current-date-time} ]
This variable prints the current date and time in format YYYY-mm-dd .
Current Logged-in User [ @{int:current-user} ]
This variable prints the name of the current logged-in user. It is actually an array that contains the user's name, email, and ID. You can access the email or ID using the dot notation or bracket notation. For example, you could use @{int:current-user}.email or @{int:current-user}["email"] to access the user's email address.
Note: To access a value from an array, you must use a Calculate Variable step. This means that you cannot directly write @{int:current-user}.email into a field. Instead, you must create a variable and pass @{int:current-user}["email"] to the variable. You can then use the variable in the field value, such as @{var:abc}.
Trigger Based Variables
Depending on the trigger chosen, there may be additional variables available.
This Record : Field_Name [ @{current:fileld_name} ]
The This Record variables are the field values of the current record. They are available when the Automation triggers on an record.
This does not include Everyday and When a Web Hook is Received Automations.
This Before : Field_Name [ @{current:fileld_name} ]
The This Before variables are the field values of the current record before the record update triggered.
They are only available when a record is updated.
This Record : Current Comment [Content / Current Comment User / Current Comment User Email]
The This Comment variables are available when the trigger is "When a Comment is Added".
There are three ways to access the comment that was just made:
- This Record: Current Comment Content / @{000:_commentBody}: This variable contains the content of the comment.
- This Record: Current Comment User ID / @{000:_commentUserId}: This variable contains the ID of the user who made the comment.
- This Record: Current Comment User Email / @{000:_commentEmail}: This variable contains the email address of the user who made the comment.
The number 000 signifies the table ID.
This Record : Email [From / Subject / To / Direction / Body / Attachments]
When the trigger is "When an Email is Sent/Received", there are 6 email-related variables available:
- This Record: Email From / @{000:_emailFrom}: This variable contains the email address of the sender.
- This Record: Email Subject / @{000:_emailSubject}: This variable contains the subject of the email.
- This Record: Email To / @{000:_emailTo}: This variable contains the email address of the recipient.
- This Record: Email Direction / @{000:_emailDirection}: This variable contains the direction of the email (sent or received).
- This Record: Email Body / @{000:_emailBody}: This variable contains the body of the email.
- This Record: Email Attachments / @{000:_emailAttachments}: This variable contains an array of JSON objects, each of which represents an attached file. Each JSON item has two properties id and name. You can loop through the attachments and access the name or id through dot ot bracket notation.
Trigger Payload [ @{int:payload} ]
This variable is available when the "When a Webhook is Received" trigger is selected. This variable contains the payload that was passed through to the webhook. You can access it through dot or bracket notation.
Variable [ @{var:Variable_Name} ]
This variable is available if any calculated variable was created using the Calculate Variable block in the automation.
Variable: XYZ_loop [ @{var:xyx-loop} ]
The child variable is a special variable that is available within a For Each Variable Loop. It is used to access each iteration of the loop. The child variable has the same name as the loop variable, with a suffix of _loop.
