ComRaidComRaid Docs

Push providers

Configure FCM and APNs for push delivery.

Configure Firebase Cloud Messaging for Android (and optional Firebase iOS) and direct APNs credentials for Expo / native iOS tokens.

FCM (Android and Firebase iOS)

ComRaid delivers Android push through Firebase Cloud Messaging. iOS can also use FCM when the app obtains a Firebase Messaging registration token. Configure your Firebase service account in the Dashboard before sending.

  1. In Firebase, create or open a project and enable Cloud Messaging for your Android and iOS apps.
  2. Create a Firebase service account and download its JSON key.
  3. In the ComRaid Dashboard, open Push → Push settings and enter:
    • Firebase project ID
    • Client email
    • Private key
  4. Save the provider, then use Test credentials to confirm ComRaid can authenticate with Google using the saved service account (unsaved form edits are not tested). This is an auth-only check — it does not send a push to a device.
  5. To send a real test push, add a phone to the Project’s Test devices, then click Test send in the composer. Saving a token only stores it and doesn't prove it's valid (ComRaid only rejects empty tokens, whitespace, or values over 4,096 characters). FCM accepting the send is not the same as the device receiving the Notification. Permanently invalid tokens mark that Endpoint Inactive.
  6. From your product, register each device’s FCM token with POST /contacts/{external_user_id}/endpoints (see Endpoints).

The private key is never returned by the API after save. Rotate credentials in Firebase and update FCM setup whenever you need a new key.

APNs (Expo and native iOS)

Expo iOS (and native apps that obtain an APNs device token) register with provider: "apns". Configure an APNs provider key under Push → Push settings → iOS: Key ID, Team ID, Bundle ID (topic), and the .p8 private key. Set each Endpoint's apns_environment to sandbox or production (the React Native SDK defaults sandbox in __DEV__). Never send Expo Push tokens to ComRaid.

Use provider: "fcm" with platform: "ios" only when the device token is a Firebase Messaging registration token — not an APNs device token.

Next

On this page