Rudderstack

Set up Customer.io as a Rudderstack source, and use Reporting Webhooks to send email events from your workspace to any of Rudderstack’s destinations.

How it works

Rudderstack takes advantage of reporting webhooks when using Customer.io as a source. Rudderstack converts our webhooks to their event format.

  • A person’s customer_id (a legacy identifier for id) in Customer.io becomes their userId in Rudderstack.
  • If a person doesn’t have an id, Rudderstack sets a person’s email address as an anonymousId.
{
   "event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
   "object_type": "email",
   "timestamp": 1613063089,
   "metric": "opened",
   "data": {
      "trigger_id": 1,
      "customer_id": "42",
      "delivery_id": "ZAIAAVTJVG0QcCok0-0ZKj6yiQ==",
      "action_id": 96,
      "broadcast_id": 2,
      "journey_id": 5,
      "parent_action_id": 1,
      "identifiers": {
         "id": "42",
         "email": "test@example.com",
         "cio_id": "d9c106000001"
      },
      "content": "string",
      "subject": "string",
      "recipient": "test@example.com"
   }
}

Set up

  1. Go to Rudderstack and click Add Source.

  2. Select CustomerIO from the list of Event Stream sources.

    Customer.io source in RudderStack
    Customer.io source in RudderStack
  3. Assign a Name for your source and click Next. To connect this source to a RudderStack warehouse destination, the source name should match the name of your warehouse schema. Note the source Write key: you’ll need this key for your reporting webhook URL.

  4. In Customer.io, go to Data & Integrations > Integrations and find the Reporting Webhooks integration.

    Customer.io reporting webhooks
    Customer.io reporting webhooks
  5. Click Add Reporting Webhook and add the webhook URL from the Source Settings page in your RudderStack dashboard. Make sure you add your source’s write key as query parameter to the URL. See Rudderstack’s documentation for more information about the data plane URL.

    Find your rudderstack webhook URL
    Find your rudderstack webhook URL
  6. Select the events that you want to send to Rudderstack. Rudderstack only supports the following Email Events:

    Delivered

    The delivery provider reported that the email was delivered to the recipient’s inbox.

    Opened

    A recipient opened an email.

    Clicked

    A recipient clicked a tracked link in an email.

    Bounced

    The delivery provider reported that it was unable to deliver an email to a recipient.

    Spammed

    A recipient marked an email as spam.

    Unsubscribed

    A recipient unsubscribed via a particular email.

    Select the events that you want to forward to a destination through Rudderstack
    Select the events that you want to forward to a destination through Rudderstack
  7. Click Save and Enable Webhook.

Supported events

RudderStack only supports the following email events.

Email EventDescription
DeliveredThe delivery provider reported that the email was delivered to the recipient’s inbox.
OpenedA recipient opened an email.
ClickedA recipient clicked a tracked link in an email.
BouncedThe delivery provider reported that it was unable to deliver an email to a recipient.
SpammedA recipient marked an email as spam.
UnsubscribedA recipient unsubscribed via a particular email.
Copied to clipboard!