Step-by-step guide to ingest event data from into RudderStack is a popular marketing platform for sending targeted emails and push and SMS notifications to improve customer engagement and thereby the overall conversion rate. It leverages real-time behavioral data and advanced segmentation techniques across the web and mobile platforms to improve your customers' overall experience.
This document guides you in setting up as a source in RudderStack. By adding a reporting webhook in that points to RudderStack, you can send events to RudderStack whenever sends messages to your customers. Events such as messages delivered, opened, and clicked by the customers are also captured and sent to RudderStack.

Getting Started

In order to add as a source in RudderStack, please follow these steps:
    From your RudderStack dashboard, click on Add Source. From the list of sources, select, as shown:
    Enter the name of your source.
If you wish to connect this source to our warehouse destinations, the source name should match the name of your warehouse schema.
    Once you have entered the name of your source, click on Next and save the source.
    Head over to your account and navigate to the Integrations page from the sidebar. Look for the integration Reporting Webhooks, as shown:
    Click on Add Webhook and add a webhook pointing to the URL in the following format:<your_dataplane_url>/v1/webhook?writeKey=<your_customer_io_source_write_key>
An example URL would like the following:
Make sure to add the writeKey as query parameter to the URL. This is required to prevent the webhook from failing for the lack of a valid write key.
A sample figure highlighting this step is as shown:
Webhook Settings
    Finally, save the webhook.

Supported Events

We currently support only the Email Events as listed in the table below:
Email Event
The delivery provider's report that the email was delivered to the inbox of the recipient
An email was opened by the recipient
A tracked link in an email was clicked by the recipient / customer
The delivery provider's report that it was unable to deliver the email to the recipient
An email was marked as spam by the recipient
The customer unsubscribed via a particular email

RudderStack Event Transformation

The webhook event from is ingested into RudderStack after converting it into the format of a RudderStack event. The customer_id set by is set as userId . In cases where does not send the customer_id, the email address of the user is set as anonymousId.

Contact Us

If you come across any issues while configuring as a source with RudderStack, please feel free to contact us. You can also start a conversation on our Slack channel - we will be happy to talk to you!
Last modified 9mo ago