Configuring Integrations

This page covers how to add Integrations. For information about specific integrations, find the integration in the navigation menu on the left side.

Integrations, as the name suggests, provide native integrations between PixieBrix and your favorite apps, services, and APIs.

To use an integration, you first create a configuration that lets PixieBrix know how to connect to your account.

There are two places where integration configurations can be configured and stored:

  1. β›… Cloud Integrations: configured in the Admin Console. These configurations work across your PixieBrix Browser Extension installs and can be shared with your team

  2. πŸ’» Local Integrations: configured in the Extension Console. These configurations are stored on your device. If you uninstall the PixieBrix Browser Extension, local configurations are deleted.

Configuring Cloud Integrations

Cloud Integrations are configured in the Admin Console. Navigate to the PixieBrix Admin Console :

Types of Cloud Configurations

Inside the Admin Console, you'll see two Integrations sections on the left side nav.

Personal Cloud Integrations

In the Admin Console, the Personal Cloud Integrations screen is available from the left side nav, just below the Personal section heading.

Add an integration here if: βœ… You use PixieBrix on multiple machines or browser profiles βœ… Your teammates do not need access to this integration

Team Cloud Integrations

Further down the left side nav, you'll see another section with your team name and an item for Team Integrations.

Add an integration here if: βœ… You need other people on your team to use this integration in a mod

Adding a Cloud Configuration

The Cloud Integrations screen lists configured Cloud Integrations.

To add a new Cloud Integration Configuration, click + Add Integration

When you click Add Integration, PixieBrix will display a modal where you can search the available integrations. To add the integration, click the row in the search results.

Click on the integration you want to add. PixieBrix will show an integration configuration form

Editing a Cloud Configuration

All integration configurations include three fields:

  • Label: a label to help identify the configuration. It is helpful when creating multiple configurations for the same integration.

  • Integration (Readonly): the integration’s unique id. It is helpful for verifiying you’re configuring the correct integration if multiple integrations have similar names

  • Pushdown to Browser: Pushdown the configuration to the Browser Extension. API requests will be transmitted directly from the browser to the API.

In addition to these fields, PixieBrix will show the integration-specific fields. For example, here is the Configuration form for Airtable:

Once you’ve completed the form, click Save to create/update the configuration.

Deleting a Cloud Configuration

To delete a Cloud Integration, click Configure under the Actions column.

When the modal appears, click the Delete button

Configuring Local Integrations

Local Integrations are configured in the Extension Console. These configurations are stored locally on your device. They are never transmitted to the PixieBrix servers or shared with your team.

Add an integration here if: βœ… You don't want to store credentials in the cloud βœ… You do not want to access this integration on another machine or browser profile βœ… You do not want your team to have access to this integration

You can access the integrations screen from the left side nav in the Extension Console.

Adding a Local Configuration

To add a Location Integration Configuration, click Add Integration. Just like with Cloud Integrations, PixieBrix will show a modal to search and select an integration to configure.

PixieBrix will display a modal where you can search the available integrations. To add the integration, click the row in the search results and select Configure.

Provide the necessary details. This will vary by integration. Click Save when you're finished.

Editing a Local Configuration

Editing Local Integration Configurations is the same as for Cloud Integrations, except there is no Pushdown to Broswer option.

Deleting a Local Configuration

To delete a local configuration. Click the three dot menu for the Integration Configuration and click Configure in the dropdown menu.

PixieBrix will display the configuration modal. In the modal, click Delete in the footer of the modal.

Using Integrations in PixieBrix Mods

In the Page Editor, if a Brick uses an integration, PixieBrix will show an integration configuration dropdown field.

For example, the Get Airtable data brick includes a field for selecting an Airtable integration configuration:

If you click the dropdown, it will display all the Cloud and Local Integration Configurations available to you. This includes all your configurations, and configurations your teammates have configured and made available to your team.

The integration field description includes a link to configure additional integrations. Clicking that link will open the Integrations screen in the Extension Console.

Last updated