Skip to main content

Retool Events reference

Reference documentation for Retool Events.

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.

Password reset required

A user must reset their password.

requestingUserEmail

The email address.

Type string
Format Email Address
Mutability Read-only
Examples
jenny@example.com

(No description available)

Type unknown
Mutability Read-only

Source Control deployment completed

Source Control has completed a deployment.

deploymentType

The type of deployment performed.

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

Manual deployment.

automatic

Automatic deployment.


status

The deployment status.

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

Successful deployment.

failure

Failed deployment.

waiting_approval

Run waiting for approval.

error

Run failed.


targetCommit

The full commit hash that was deployed.

Type string
FormatUUID
Mutability Read-only
Examples
"a1b2c3d4e5f67890123456789abcdef123456789"

User created

A user was created.

userEmail

The email address.

Type string
Format Email Address
Mutability Read-only
Examples
jenny@example.com

User invited

A user was invited to join the organization.

inviteId

(No description available)

Type unknown
Mutability Read-only

(No description available)

Type unknown
Mutability Read-only

invitingUserEmail

The email address.

Type string
Format Email Address
Mutability Read-only
Examples
jenny@example.com

User requested access

A user requested access to join the organization.

requestingUserEmail

The email address.

Type string
Format Email Address
Mutability Read-only
Examples
jenny@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
Mutability Read-only
Examples
true

createdAt

The timestamp for when the user was created.

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

email

The email address.

Type string
Format Email Address
Mutability Read-only
Examples
jenny@example.com

firstName

The first name.

Type string
Format Plain Text
Mutability Read-only
Examples
"Jenny"

id

The ID of the user.

Type string
FormatUUID
Mutability Read-only
Default
loginAttempted1
Examples
"user_366e154sdfg34b9bdeds32936"
button1

isAdmin

Whether the user is an admin.

Type boolean
Mutability Read-only

lastActive

The timestamp for when the user was last active.

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

lastName

The last name.

Type string
Format Plain Text
Mutability Read-only
Examples
"Appleseed"

metadata

Metadata for the login attempted event.

Type object
Mutability Read-only

userType

The type of user.

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

Default user.

mobile

Mobile user.

embed

Embedded user.