Firebase / Firestore Help & Support

  • How to Get Started with Firebase
  • Common Problems with Firebase
  • Popular Things To Do With Firebase

How to Get Started with Firebase

About Firebase's Integration#

  • Paid/versioned account: Their plans start from free, more info here: https://zapier.com/apps/firebase/pricing
  • Partner’s Documentation: https://firebase.google.com/support

Connecting with Firebase#

To get started with Firebase on Zapier, first you will need to connect your Firebase project/account with your Zap

select account

Next, you'll be asked to enter the Project's ID:

config account

To find your Project's ID, please follow these steps:

""

Google will verify that you want to give permission for the integration to access the project:

""

If you have entered your details correctly, you will be successfully connected.

""

Common Problems with Firebase

Creating a Firestore Structured Query for a Trigger#

When using a Zap to trigger on new documents within a Firestore collection, it's important to build a Structured Query that returns the selected documents in the correct order, otherwise your Zap may never see the new documents.

The orderBy property in your query needs to ensure that the new documents are at the "top" of the search results, so that the Zap can see those documents. In most cases, you'll want to use DESCENDING, like this:

If your field has spaces in it, you will need to surround it with backticks. For example:

You can learn more about the correct syntax/structure here: https://cloud.google.com/firestore/docs/reference/rest/v1beta1/StructuredQuery#Order

Creating a Firestore Structured Query for a Search#

When using a Zap to search for a specific document within a Firestore collection, it's important to build a Structured Query that contains the appropriate where clause, like this:

In your Zap, the "compare to" value is probably something that you'll want to connect with a previous step within your Zap, using the "plus" button on the right-hand side of the input field within the Zap Editor.

You can learn more about the correct syntax/structure here: https://cloud.google.com/firestore/docs/reference/rest/v1beta1/StructuredQuery#Filter

Invalid data error (Couldn't parse JSON object)#

Sometimes you will see an error that says "Invalid data; couldn't parse JSON object, array, or value. Perhaps you're using invalid characters in your key names."

This error occurs when the fields you are trying to send to Firebase contain invalid characters. Firebase prohibits key names from containing:

  • . (period)
  • $ (dollar sign)
  • [ (left square bracket)
  • ] (right square bracket)
  • # (hash or pound sign)
  • / (forward slash)

To get around the error, you will need to manually assign names to the keys. See the Customizing Fields to Store section for details.

My Firebase Zap isn't triggering when I add new records#

New records need to appear at the end of your data for this to work. If you aren't using push IDs, your records need to be ordered lexicographically or by priority so that new records appear last.

A simple way to accomplish this is by calling setWithPriority and using Firebase.ServerValue.TIMESTAMP to order by timestamp.

Error: Empty key in "Path to data". Probably tried to use a field which was empty as part of the path#

Make sure you remove the beginning and ending / from the Path field.

For example, /customers/new/ becomes customers/new.

I'm getting "Firebase paths/keys cannot contain the characters $ # . [ ]" but there are no invalid characters included in the path/keys#

Users sometimes encounter this error if anything that is being supplied in the value has a pipe ( | ) character in it. For example:

pipe in value

This has to due with the way our system encodes key/value pairs. The recommend solution is to not include invalid characters in the value that is included or use a Formatter step to remove the characters.

Popular Things To Do With Firebase

  • Turn collaborators from new Firestore documents into Mailchimp subscribers

    Firebase / Firestore + Mailchimp

    Try It
  • Add Mailchimp subscribers from new child objects in Firebase Realtime Databases

    Firebase / Firestore + Mailchimp

Connect the apps you use every day

Get started with a Free account

Or
By signing up, you agree to Zapier’s Terms of Service