Firebase Cloud Messaging Quickstart

The Firebase Cloud Messaging quickstart demonstrates how to:

  • Request permission to send app notifications to the user.
  • Receive FCM messages using the Firebase Cloud Messaging JavaScript SDK.

Getting Started

  1. Create your project in the Firebase Console by following Step 1: Create a Firebase Project
  2. Register a web app by following Step 2: Register your app with Firebase.
    1. You don't need to add Hosting right now, and you can skip the "Add Firebase SDK" step in the console's "Add Firebase to your web app" flow.
    2. Remember to click "Register App" or "Continue to console" at the bottom of the "Add Firebase to your web app" flow.
  3. Open Project and go to Project settings > Cloud Messaging and there in section Web configuration click Generate key pair button.
  4. Copy public key and in index.html file replace <YOUR_PUBLIC_VAPID_KEY_HERE> with your key.
  5. You must have the Firebase CLI installed. If you don't have it install it with npm install -g firebase-tools and then configure it with firebase login.
  6. On the command line run firebase use --add and select the Firebase project you have created.
  7. On the command line run firebase serve -p 8081 using the Firebase CLI tool to launch a local server.
  8. Open http://localhost:8081 in your browser.
  9. Click REQUEST PERMISSION button to request permission for the app to send notifications to the browser.
  10. Use the generated Instance ID token (IID Token) to send an HTTP request to FCM that delivers the message to the web application, inserting appropriate values for YOUR-SERVER-KEY and YOUR-IID-TOKEN.

NOTE: If your payload has a notification object, setBackgroundMessageHandler will not trigger. Read here for more information.


POST /fcm/send HTTP/1.1
Authorization: key=YOUR-SERVER-KEY
Content-Type: application/json

  "notification": {
    "title": "Portugal vs. Denmark",
    "body": "5 to 1",
    "icon": "firebase-logo.png",
    "click_action": "http://localhost:8081"
  "to": "YOUR-IID-TOKEN"


var key = 'YOUR-SERVER-KEY';
var to = 'YOUR-IID-TOKEN';
var notification = {
  'title': 'Portugal vs. Denmark',
  'body': '5 to 1',
  'icon': 'firebase-logo.png',
  'click_action': 'http://localhost:8081'

fetch('', {
  'method': 'POST',
  'headers': {
    'Authorization': 'key=' + key,
    'Content-Type': 'application/json'
  'body': JSON.stringify({
    'notification': notification,
    'to': to
}).then(function(response) {
}).catch(function(error) {


curl -X POST -H "Authorization: key=YOUR-SERVER-KEY" -H "Content-Type: application/json" -d '{
  "notification": {
    "title": "Portugal vs. Denmark",
    "body": "5 to 1",
    "icon": "firebase-logo.png",
    "click_action": "http://localhost:8081"
  "to": "YOUR-IID-TOKEN"
}' ""

App focus

When the app has the browser focus, the received message is handled through the onMessage callback in index.html. When the app does not have browser focus then the setBackgroundMessageHandler callback in firebase-messaging-sw.js is where the received message is handled.

The browser gives your app focus when both:

  1. Your app is running in the currently selected browser tab.
  2. The browser tab's window currently has focus, as defined by the operating system.


© Google, 2016. Licensed under an Apache-2 license.