Cratejoy Integration

Cratejoy Integration


Thank you for your interest in using Customer.io with Cratejoy to power your messaging to your box subscribers.

Enabling the Integration

This integration requires a new Customer.io account - if you currently are using Customer.io and would like to use this integration, please contact win@customer.io

To start sending data from Cratejoy into Customer.io, submit this form. Upon submission, a backend service will create the connection between your Cratejoy store and a new Customer.io account.

Using Customer.io for the First Time

Shortly after you submit the form, you should receive an email from Customer.io asking to confirm your email address. Once confirmed, you'll be able to log into your new Customer.io account with the password you entered on the integration form.

When you first log in - you should already see events from your Cratejoy store in the activity feed, reflecting live actions occuring in your store. The customer backfill will also be occuring in the background and will complete in a period of time based on how many customers you have. See below for more information on the Cratejoy events recorded in Customer.io.

To learn the basics of Customer.io, please check out the following articles:

Events

Events are actions users take in your store. In the case of the Cratejoy integration, events also include shipment events - see the chart below for the full list of events:

Event Name Event Description
checkout_failed One of your customers attempted to checkout but failed due to invalid input, or payment.
customer_new A new user has registered on your store. This can happen as part of a checkout, or independently.
address_updated A customer address has been updated.
billing_updated A customer billing record has been updated.
order_updated You cancelled or changed the status of an order.
order_new An order has been successfully placed on your store.
shipment_cancelled You cancelled a shipment.
shipment_shipped You marked a package as shipped.
shipment_cancelled You or your customer cancelled a subscription.
subscription_new A subscription has been created on your store.
subscription_renew_failed A subscription did not successfully charge on its renewal date.
subscription_renewed A subscription has successfully paid for a new cycle and generated new shipments.
subscription_updated One of your customers updated their subscription variants, terms, or products for their next renewal.
transaction_new A new transaction was created.

These events and their descriptions are directly mapped from Cratejoy's webhook events, which are documented here.

Only events that occur after the integration is enabled will be synced to Customer.io. Events occurring before the integration is enabled will not be backfilled.

Gift Recipients

Please note that gift recipients are a special use case in the Cratejoy Integration. Whenever an order is placed as a gift, a profile will be made for the gift recipient with corresponding events for the gift order. All gift recipients will have the attribute gift_recipient equal to true.

Was this article helpful?