Segment

Edesy Email currently supports both ingesting events from Segment and sending events to Segment. Follow the instructions for each below.

Outbound

To setup Edesy Email as a source for events going into Segment, you first need to create a Source in Segment.

1. Open Segment and navigate to Connections -> Sources and click Add Source
2. Search for Node.js and select that server source to be added
3. Pick whatever name you would like and hit Add Source to finish
4. The source screen should present you with a Write Key which is needed to setup the intergration on Edesy Email. Copy this for later.
5. Navigate to Edesy Email and go to Settings -> Integrations
6. Hit Add Integration and pick Segment
7. Enter the Write Key for the Segment Source you previously created and hit save.
8. That's it! After you save the integration all future events will flow into the source you created.

Inbound

There is currently no Destination in Segment for Edesy Email, however Edesy Email does have a Segment compatible endpoint that can be used for webhooks.

1. Open Edesy Email and go to Settings -> API Keys
2. Hit Create Key, enter Segment (or whatever you want) as the name, Public as the scope and then hit create.
3. Copy the key so you have it for later
4. Open Segment and navigate to Connections -> Destinations and click Add Destination
5. Search for Webhooks and pick the Destination title Webhooks (Actions)
6. Hit Configure Webhooks (Actions) in the top right of the next screen
7. Select whatever data source you want to ingest data from and hit Next
8. Enter a name and then hit Select destination
9. Create a new Mapping of type Send
10. For the first section, pick Event Type as the condition and Track as the event type. Edesy Email supports Track, Identify and Alias events, so select all three as separate conditions to receive all data.
11. Under mappings, enter the following information:
    • URL: Enter your domain along with the path /api/client/segment (i.e. https://test.com/api/client/segment)
    • Method: POST
    • Headers: Set the key as Authorization and the value to Bearer API_KEY where API_KEY is the key you created in Edesy Email
    • Data: Leave as is
    • Enable Batching: Set to true
12. Save the destination and enable to start sending events into Edesy Email!.