Nova Admin Docs
Integrations

Nova Lookup

How to set up a Nova Lookup service account and connect it to Nova Admin.

Paste a Firebase service-account JSON for the Nova main project (the one that hosts the Users collection). Generate one from Firebase Console → Project Settings → Service Accounts → Generate New Private Key.

Prerequisites

  • A Nova Lookup project and appropriate IAM permissions.
  • See Firebase Admin SDK setup for the specific roles and APIs required.

Steps

  1. Open Firebase Console for your Nova main project
  2. Project Settings → Service Accounts → Generate New Private Key
  3. Copy projectId, clientEmail, and privateKey from the downloaded JSON

Credential fields

FieldRequiredNotes
Firebase Project IDYesnova-prod
Service Account EmailYesfirebase-adminsdk-xxx@my-project.iam.gserviceaccount.com
Service Account Private KeyYesSecret — stored encrypted.

Troubleshooting

  • PERMISSION_DENIED: the service account is missing a required IAM role — review the steps above.
  • invalid_grant: Invalid JWT: the private key was pasted with newlines stripped — re-paste from the original JSON.
  • Need help?: refer to the Nova Lookup documentation.

On this page