Authentication trigger functions in Firebase - Step-by-Step Execution

Process Flow - Authentication trigger functions

User signs up

↓

Firebase detects auth event

↓

Trigger function runs

↓

Function executes custom code

↓

Optional: Modify user data or send notifications

↓

Function completes, auth process continues

When a user signs up, Firebase detects this event and runs a trigger function to execute custom code before continuing.

Execution Sample

Firebase

const functions = require('firebase-functions');

exports.onUserCreate = functions.auth.user().onCreate((user) => {
  console.log('New user:', user.email);
  return null;
});

This function runs when a new user signs up and logs their email.

Process Table

Step	Event Detected	Trigger Function Action	Output/Effect
1	User signs up with email	Trigger function onCreate starts	Logs 'New user: [e-mail]'
2	Function completes	Returns null	No changes to user data
3	Auth process continues	User account created	User can now use the app

💡 Trigger function ends after logging and returning null, allowing auth to complete

Status Tracker

Variable	Start	After Step 1	After Step 2	Final
user.email	undefined	[e-mail]	[e-mail]	[e-mail]
function return	undefined	undefined	null	null

Key Moments - 2 Insights

Why does the trigger function run automatically when a user signs up?

Because Firebase listens for auth events and automatically calls the trigger function, as shown in execution_table step 1.

What happens if the trigger function does not return anything?

Returning null or a promise signals completion; without it, Firebase may wait indefinitely. See execution_table step 2.

Visual Quiz - 3 Questions

Look at the execution_table, what is logged when a new user signs up?

A 'New user: [e-mail]'

B 'User signed in'

C 'Authentication failed'

D 'User deleted'

💡 Hint

Check the Trigger Function Action column in step 1 of execution_table

At which step does the trigger function complete its execution?

A Step 1

B Step 3

C Step 2

D Never completes

💡 Hint

Look at the Function completes row in execution_table

If the trigger function modifies user data, when does this happen in the flow?

A After the function completes

B During the trigger function execution

C Before the auth event is detected

D After the user logs out

💡 Hint

See concept_flow where custom code runs inside the trigger function

Concept Snapshot

Authentication trigger functions run automatically when users sign up.
They allow running custom code like logging or modifying user data.
Functions must return null or a promise to signal completion.
This happens before the auth process finishes.
Use onCreate for sign-up triggers.

Full Transcript

When a user signs up, Firebase detects this authentication event and automatically runs a trigger function. This function can execute custom code such as logging the user's email or modifying user data. The function must return null or a promise to indicate it has finished running. After the function completes, the authentication process continues and the user can access the app. This flow ensures you can add custom behavior during user authentication events without interrupting the normal sign-up process.