> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retention Science

> Integration details and setup guide for the Retention Science connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                  |
| ----------------------------------- | ------------------------ |
| **Authentication**                  | API Key (Header: ApiKey) |
| **Two-Way Sync**                    | No                       |
| **Events Supported**                | No                       |
| **Realtime**                        | Polling                  |
| **Supports Rate Limiting**          | Yes                      |
| **Authentication Scopes Supported** | N/A (API Key)            |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **Retention Science**:

* **Customers**
* **Orders**
* **Products**
* **Campaigns**
* **Events**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                        |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Contact Retention Science for trial or demo access. [Contact for demo](https://retentionscience.com/contact/) |
| **Requires paid sandbox?**                         | No specific sandbox mentioned. Contact their team for development environment.                                |
| **Requires partnership to obtain authentication?** | No, but you need an active Retention Science account.                                                         |

***

### Authentication (API Key)

For customers who want to completely whitelabel their authentication experience, you can provide your own developer keys instead of using Alloy Automation's.

<steps>
  <step title="Create Retention Science Account">
    Contact Retention Science at [https://retentionscience.com](https://retentionscience.com) to set up an account or log in to your existing account
  </step>

  <step title="Navigate to Settings">
    1. Log in to your Retention Science dashboard at [https://data.retentionscience.com](https://data.retentionscience.com)
    2. Navigate to **Settings** or **Account Settings**
    3. Look for **API Settings** or **Integrations**
  </step>

  <step title="Generate or Locate API Key">
    1. Find the **API Key** section in your settings
    2. Copy your existing API key or click **Generate New Key**
    3. Store the key securely (it provides access to your account data)
  </step>

  <step title="Configure in Alloy Automation">
    1. In Alloy Automation, enter your Retention Science API key
    2. The key will be sent in the `ApiKey` header for all API requests
    3. Test the connection to verify authentication
  </step>
</steps>

For more information, visit the [Retention Science documentation](https://retentionscience.com).

***

## Use Cases

### 1) Customer lifecycle marketing automation

Sync customer and order data from your e-commerce platform to Retention Science to enable AI-powered lifecycle marketing campaigns that increase customer retention and lifetime value.

### 2) Personalized email campaigns

Use Retention Science's predictive analytics by integrating customer behavior data to trigger personalized email campaigns at optimal times with product recommendations.

### 3) Churn prevention

Automatically identify at-risk customers in Retention Science based on purchase patterns and trigger win-back campaigns or special offers to prevent churn.

### 4) Cross-channel marketing optimization

Integrate Retention Science with your marketing stack to coordinate email, SMS, and other channel campaigns based on AI-driven customer insights and predictions.

### 5) Customer analytics and reporting

Pull campaign performance, customer engagement, and lifecycle metrics from Retention Science into your analytics platform for comprehensive marketing ROI analysis.

***

## API Gotchas

* **API key header format:** Retention Science uses a custom `ApiKey` header for authentication. Ensure your HTTP client is configured to send the API key in this specific header, not a standard Authorization header.

* **Limited public documentation:** Retention Science's public API documentation may be limited. Contact their support team for detailed API specifications and integration guidance.

* **Data freshness:** When syncing customer and order data to Retention Science, ensure data is sent promptly to enable accurate predictive analytics and timely campaign triggers.

* **Rate limiting:** Implement proper rate limiting and retry logic to avoid API throttling during high-volume data syncs or campaign operations.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.