This guide covers how to:

  1. Create a Propel Application.
  2. Create the destination in Airbyte.
  3. Create your first Airbyte to Propel connector.
  4. Lastly, how to stop Airbyte.

Prerequisites

To connect Propel to Airbyte, you need the following:


1

Create a Propel Application

You must create a Propel Application. Propel Applications provide the API credentials, allowing the Airbyte destination to access the Propel API.

Follow the guide to Create a Propel Application.

  • Give it a Unique Name. For example, ‘Airbyte Destination’.
  • Provide a Description. For example, ‘The Airbyte Destination app’.
  • In the API scopes section, in the Scopes drop-down menu, select the ADMIN scope.
  • Select a P1_X_SMALL Propeller. This is sufficient for Airbyte Applications.

Make a note of the Application ID and secret. You will need them to configure Airbyte.

2

Create a Propel destination in Airbyte

Only Airbyte Open Source supports the Propel destination. In this section, you’ll learn how to set up Airbyte and connect your Propel destination.

Requirements

  • Docker Desktop (Docker terms apply)

Set up Airbyte locally

  1. Install Docker Desktop.
  2. Clone the Airbyte repo and run the startup script:
git clone https://github.com/airbytehq/airbyte.git
cd airbyte
./run-ab-platform.sh
  1. Open Airbyte in the browser at http://localhost:8000.

Create your first Airbyte to Propel connection

Now that Airbyte is running locally, let’s set up the custom Propel destination.

  1. In the Airbyte dashboard, click “Settings” on the bottom left.
  2. Click “Destinations” on the left sidebar.
  3. Click the “New connector” button.
  4. Click the “Add a new Docker connector” option.
  5. Fill in the connector values as follows:
  • Connector display name: Propel
  • Docker repository name: propeldata/airbyte-propel-destination
  • Docker image tag: 0.0.1
  • Connector Documentation URL: https://www.propeldata.com/docs/connect-your-data/airbyte

You can find the Propel Airbyte destination Dockerhub release page here.

Enter the Propel Application credentials in Airbyte

You’re now ready to connect Propel to Airbyte.

  1. Enter the Application ID and secret you found in Step 1.
  1. Click “Set up destination”. You should get a success message that the connection test passed.
3

Create a new connection

Now that the Propel destination is set up, you can create a new connection to sync data from any Airbyte source to Propel.

  1. Click on “Create a connection”.
  2. Select the source you want to sync data from.
  3. Configure the sync settings.
  1. Finally, click “Set up connection”.
4

Stopping Airbyte

At any point, you can disable any incremental or full syncs by going to the ‘Connection’ settings page and clicking ‘Delete this connection’. This will not touch any of the source or destination data, but will prevent Airbyte from doing any further operations.