Skip to main content

Retool Events reference

Use Retool Events to build workflows that run whenever certain events occur within your organization. Event payloads contain properties with information related to the event. You can reference these within Retool Event-related workflows to perform actions or send notifications automatically.

Learn more about setting up Retool Events.

Password reset required​

A user must reset their password.

requestingUserEmail​

The email address.

Type string
Format Email Address
Configurability Read-only
Defaultnull
Examples
falsejenny@example.com

(No description available)

Type unknown
Configurability Read-only
Defaultnull

Source Control deployment completed​

Source Control has completed a deployment.

deploymentType​

The type of deployment performed.

Type string
Format Plain Text
Configurability Read-only
Allowed Values
ValueDescription
manual

Manual deployment.

automatic

Automatic deployment.

Defaultnull

status​

The deployment status.

Type string
Format Plain Text
Configurability Read-only
Allowed Values
ValueDescription
success

Successful deployment.

failure

Failed deployment.

waiting_approval

Run waiting for approval.

error

Run failed.

Defaultnull

targetCommit​

The full commit hash that was deployed.

Type string
FormatUUID
Configurability Read-only
Defaultnull
Examples
false"a1b2c3d4e5f67890123456789abcdef123456789"

User created​

A user was created.

userEmail​

The email address.

Type string
Format Email Address
Configurability Read-only
Defaultnull
Examples
falsejenny@example.com

User invited​

A user was invited to join the organization.

inviteId​

(No description available)

Type unknown
Configurability Read-only
Defaultnull

(No description available)

Type unknown
Configurability Read-only
Defaultnull

invitingUserEmail​

The email address.

Type string
Format Email Address
Configurability Read-only
Defaultnull
Examples
falsejenny@example.com

User requested access​

A user requested access to join the organization.

requestingUserEmail​

The email address.

Type string
Format Email Address
Configurability Read-only
Defaultnull
Examples
falsejenny@example.com

Login attempted​

A user attempted to log in. This event runs after a user has been authenticated, but before they complete the login process.

active​

Whether the user is active.

Type boolean
Format True/False
Configurability Read-only
Defaultnull
Examples
falsetrue

createdAt​

The timestamp for when the user was created.

Type string
Format Date and Time
Configurability Read-only
Defaultnull
Examples
false"2023-10-01T12:00:00Z"

email​

The email address.

Type string
Format Email Address
Configurability Read-only
Defaultnull
Examples
falsejenny@example.com

firstName​

The first name.

Type string
Format Plain Text
Configurability Read-only
Defaultnull
Examples
false"Jenny"

id​

The ID of the user.

Type string
FormatUUID
Configurability Read-only
DefaultloginAttempted1
Examples
false"user_366e154sdfg34b9bdeds32936"
falsebutton1

isAdmin​

Whether the user is an admin.

Type boolean
Configurability Read-only
Defaultnull

lastActive​

The timestamp for when the user was last active.

Type string
Format Date and Time
Configurability Read-only
Defaultnull
Examples
false"2023-10-01T12:00:00Z"

lastName​

The last name.

Type string
Format Plain Text
Configurability Read-only
Defaultnull
Examples
false"Appleseed"

metadata​

Metadata for the login attempted event.

Type object
Configurability Read-only
Defaultnull

userType​

The type of user.

Type string
Format Plain Text
Configurability Read-only
Allowed Values
ValueDescription
default

Default user.

mobile

Mobile user.

embed

Embedded user.

Defaultnull