Skip to main content

​
Universal arguments

When Tuple executes your trigger, it passes in useful information via environment variables. These take the form TUPLE_TRIGGER_[name]. These arguments vary by trigger; however, there are two universal arguments that are available to every trigger that gets executed:
ArgumentDetails
TUPLE_TRIGGER_CURRENT_USER_EMAILYour email
TUPLE_TRIGGER_CURRENT_USER_FULL_NAMEYour full name

​
Events

The complete list of lifecycle events that you can respond to with triggers.

​
Call initiated

call-initiated Fired when you start an outgoing call to another person via the popover interface. Calling someone via the popover UI
ArgumentDetails
TUPLE_TRIGGER_CALLEE_EMAILThe email of the person you’re calling.
TUPLE_TRIGGER_CALLEE_FULL_NAMEThe full name of the person you’re calling.

​
Call incoming

call-incoming Fired when another participant calls your machine. Receiving an incoming call
ArgumentDetails
TUPLE_TRIGGER_CALLER_EMAILThe email of the person calling you.
TUPLE_TRIGGER_CALLER_FULL_NAMEThe full name of the person calling you.

​
Call rejected

call-rejected Fired when the person you’re calling rejects your call.
ArgumentDetails
TUPLE_TRIGGER_CALLEE_EMAILThe email of the person you’re calling.
TUPLE_TRIGGER_CALLEE_FULL_NAMEThe full name of the person you’re calling.

​
Call timed out

call-timed-out Fired when your outgoing call times out.
ArgumentDetails
TUPLE_TRIGGER_CALLEE_EMAILThe email of the person you’re calling.
TUPLE_TRIGGER_CALLEE_FULL_NAMEThe full name of the person you’re calling.

​
Call connected

call-connected Fired when your call is fully connected. (Receives no additional arguments)

​
Call ended

call-ended Fired when your call ends.
ArgumentDetails
TUPLE_TRIGGER_CALL_LENGTHThe duration that you were on the call in seconds.

​
Call recording complete

call-recording-complete Fired when a call recording finishes, either because the call ended or recording was disabled.
ArgumentDetails
TUPLE_TRIGGER_CALL_ARTIFACTS_DIRECTORYThe filesystem path to the directory containing the call recording artifacts.

​
Room joined

room-joined Fired when you or someone else joins one of your team’s rooms.
ArgumentDetails
TUPLE_TRIGGER_IS_SELF”true” when this is being fired because you joined a room. “false” when it was someone else.
TUPLE_TRIGGER_ROOM_NAMEThe name of the room being joined.
TUPLE_TRIGGER_EMAILThe email of the person joining the room.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person joining the room.

​
Room left

room-left Fired when you or someone else leaves one of your team’s rooms.
ArgumentDetails
TUPLE_TRIGGER_IS_SELF”true” when this event was fired because you left a room. “false” when someone else did.
TUPLE_TRIGGER_ROOM_NAMEThe name of the room being left.
TUPLE_TRIGGER_EMAILThe email of the person leaving the room.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person leaving the room.

​
Screen share started

screen-share-started Fired when you or someone else starts sharing their screen on a call.
ArgumentDetails
TUPLE_TRIGGER_IS_SELF”true” when the event was fired because you started sharing your screen. “false” when someone else did.
TUPLE_TRIGGER_EMAILThe email of the person sharing their screen.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person sharing their screen.

​
Screen share ended

screen-share-ended Fired when you or someone else stops sharing their screen on a call.
ArgumentDetails
TUPLE_TRIGGER_IS_SELF”true” when you stopped sharing your screen. “false” when someone else did.
TUPLE_TRIGGER_EMAILThe email of the person stopping their screen share.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person stopping their screen share.

​
Webcam share started

webcam-share-started Fired when you or someone else starts sharing their webcam on a call.
ArgumentDetails
TUPLE_TRIGGER_IS_SELF”true” when you started sharing your webcam. “false” when someone else did.
TUPLE_TRIGGER_EMAILThe email of the person sharing their webcam.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person sharing their webcam.

​
Webcam share ended

webcam-share-ended Fired when you or someone else stops sharing their webcam on a call.
ArgumentDetails
TUPLE_TRIGGER_IS_SELF”true” when you stopped sharing your webcam. “false” when someone else did.
TUPLE_TRIGGER_EMAILThe email of the person no longer sharing their webcam.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person no longer sharing their webcam.

​
Participant joined

participant-joined Fired whenever someone joins your call, whether it’s a call starting, someone being added, or someone joining the room you’re in.
ArgumentDetails
TUPLE_TRIGGER_EMAILThe email of the person that joined your call.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person that joined your call.

​
Participant left

participant-left Fired whenever someone leaves your call.
ArgumentDetails
TUPLE_TRIGGER_EMAILThe email of the person that left your call.
TUPLE_TRIGGER_FULL_NAMEThe full name of the person that left your call.