This guide covers how to:
  1. Create a Segment Data Pool
  2. Create the Segment webhook destination
  3. Preview data in Propel

​
Requirements

​
Step 1: Create a Segment Data Pool

First, create a Segment Data Pool in Propel. This will give you a dedicated HTTP endpoint for Segment to send events to.
1

Navigate to Data Pools

In the Console, click on “Data Pools” in the left-hand menu. Click on “Create Data Pool” and select “Twilio Segment”.
Creating a new Twilio Segment Data Pool in the Propel Console
2

Define the schema

The default schema contains two columns:
ColumnTypeDescription
_propel_received_atTIMESTAMPThe timestamp when the event was collected in UTC.
_propel_payloadJSONThe value in the records[i].data of the event.
On the right, you’ll see a sample Segment event.
Defining the schema for a Twilio Segment Data Pool
With the sample event or your own, you can:
  • Extract top-level properties to create columns representing the top-level keys.
  • Extract nested properties to create columns representing the nested JSON keys.
If a required field is missing from the sample event, Propel will reject the event with an HTTP 400 Bad Request error.
3

Configure Authentication

You can enable basic authentication to secure your endpoint.After configuring, click “Next” to proceed.
Configuring authentication settings for a Twilio Segment Data Pool
4

Configure the table settings

Select “Append-only”.To learn more, read out guide on Selecting table engine and sorting key.
Selecting table settings for a Twilio Segment Data Pool
Answer the questions in the wizard to complete the setup.
Completing the table settings wizard for a Twilio Segment Data Pool
Confirm your table settings and click “Continue”.
Confirming table settings for a Twilio Segment Data Pool
5

Set a name and description

Enter a name and description for your new Data Pool and click “Next”.
Setting name and description for a Twilio Segment Data Pool
After creating the Data Pool, you’ll be provided with a unique HTTP endpoint.You’ll need this endpoint and key to configure your Segment webhook destination.
Viewing the created Twilio Segment Data Pool details

​
Step 2: Create the Segment webhook destination

Once you have the Data Pool created, we’ll need to create a Segment webhook destination that sends events to Propel.
1

Go to the 'Destinations' section of your Segment workspace

Once you are in the “Destinations” section of your Segment workspace, click on “Create Destination”.
Creating a new Firehose stream in AWS console
2

Search and select Webhooks

Search for “Webhooks” and select it.
Selecting Webhooks as the destination
Click “Add Destination”.
Adding the Webhooks destination
3

Select a source for the destination

Select the source you want to send events to and click “Next”.
Selecting a source for the Webhooks destination
4

Give the destination a name and create it

Name your destination “Propel”, then click “Create destination”.
Naming the Webhooks destination
5

Create a mapping

Click “Mappings” tab and click “New mapping”.
Creating a mapping for the Webhooks destination
Select the “Send an HTTP request” action, define the event trigger, and load a sample event. You’ll need the sample event to test your destination.
Defining the event trigger for the Webhooks destination
Enter your Segment Data Pool HTTP endpoint, “POST” as the method, and select batching of 500 events.
Defining the event trigger for the Webhooks destination
Finally, to test your destination, click “Send test event”.
Testing the Webhooks destination

​
Step 3: Preview data in Propel

Once events are in your Segment webhook destination, they are ingested directly to Propel. By going to your Data Pool and clicking “Preview Data”, you’ll be able to see the records as they land.
Previewing ingested data in the Propel Console