> ## 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.

# Omnisend

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

## Pre-Built Tooling

| Category                            | Details                           |
| ----------------------------------- | --------------------------------- |
| **Authentication**                  | API Key (Header-based: X-API-KEY) |
| **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 **Omnisend**:

* **Contacts**
* **Campaigns**
* **Orders**
* **Products**
* **Events**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                                              |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Yes. Omnisend offers a free plan with limited features and a 14-day free trial for paid plans. [Sign up for free](https://www.omnisend.com/signup/) |
| **Requires paid sandbox?**                         | No paid sandbox required. You can use the free plan for testing.                                                                                    |
| **Requires partnership to obtain authentication?** | No. Any user with an Omnisend account can generate API keys.                                                                                        |

***

### 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="Sign Up for Omnisend">
    Create a free account at [https://www.omnisend.com](https://www.omnisend.com) or log in to your existing account
  </step>

  <step title="Navigate to API Keys">
    1. Go to **Settings** in your Omnisend dashboard
    2. Select **Integrations** from the sidebar
    3. Click on **API Keys**
  </step>

  <step title="Generate API Key">
    1. Click **Create API Key**
    2. Enter a name for your API key (e.g., "Alloy Automation Integration")
    3. Copy the generated API key immediately (it will not be shown again)
    4. Store the key securely
  </step>

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

For more details, visit the [Omnisend API documentation](https://app.omnisend.com/integrations/api-keys).

***

## Use Cases

### 1) E-commerce customer sync

Automatically sync customer contact information, purchase history, and order data from your e-commerce platform to Omnisend to enable targeted email and SMS marketing campaigns.

### 2) Abandoned cart recovery

Trigger abandoned cart workflows in Omnisend when customers leave items in their cart on your platform, increasing recovery rates with automated follow-up messages.

### 3) Product catalog synchronization

Keep your product catalog in sync between your e-commerce platform and Omnisend to ensure accurate product recommendations and dynamic content in marketing campaigns.

### 4) Event-driven marketing automation

Send custom events from your application to Omnisend to trigger automated workflows based on user behavior, such as browsing specific categories or reaching engagement milestones.

### 5) Campaign performance reporting

Pull campaign metrics and engagement data from Omnisend into your analytics dashboard to track the ROI of marketing efforts and optimize future campaigns.

***

## API Gotchas

* **API key management:** Omnisend API keys have full access to your account. Rotate keys regularly and revoke any keys that are no longer in use to maintain security.

* **Rate limiting:** The API enforces rate limits to protect system stability. Implement exponential backoff for retry logic when you receive 429 (Too Many Requests) responses.

* **Contact consent requirements:** Omnisend enforces strict consent requirements for marketing communications. Ensure contacts have proper opt-in status before adding them to marketing lists to comply with GDPR and other regulations.

* **Batch operations:** When creating or updating multiple contacts or events, use batch endpoints when available to reduce the number of API calls and improve performance.

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