Docs / Strand / connectors/gcp-firebase

Google Firebase Cloud Messaging

Direction: Write Only | Type: gcp.firebase

Firebase Cloud Messaging (FCM) connector for sending push notifications. This is a forward-only connector.

Required Permissions#

The service account must have the following IAM permissions (or predefined role):

Operation	Required Permissions	Predefined Role
`send`	`cloudmessaging.messages.create`	Firebase Cloud Messaging Admin

Tip: Use a dedicated service account with only the Firebase Cloud Messaging Admin role. You can generate the credentials JSON from the Firebase Console under Project settings > Service accounts.

Operations#

Operation	Direction	Description
`send`	Write	Send a push notification via FCM

Connector Configuration#

Field	Required	Default	Description
Authentication Type	No	`api_key`	Uses explicit credentials (the fields below).
Project ID	Yes	-	Firebase project ID
Credentials JSON	Conditional	-	Firebase service account JSON credentials (encrypted). Required when Authentication Type is `api_key`

Node Configuration#

Field	Required	Default	Description
Token	Yes	-	FCM device token for the target device
Title	No	`Notification`	Notification title

Notification body and data

The notification body is always the incoming event payload serialized to JSON; there is no separate Body field. The full payload is also attached as the FCM data map, with each value stringified ({ "key": "value", ... }).

Output#

json


{
  "success": true,
  "status": "sent",
  "data": {
    "message_id": "projects/my-project/messages/abc123"
  },
  "service": "gcp.firebase",
  "operation": "send"
}

Example#

Connector Setup:

json


{
  "project_id": "my-firebase-project",
  "credentials_json": "{...service account JSON from Firebase Console...}"
}

Node Configuration:

Token: {{ payload.device_token }}
Title: New Alert

The notification body is the event payload as JSON, and the payload fields are sent as FCM data.

← Back to Strand docs