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

# Awtomic

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

## Pre-Built Tooling

| Category                            | Details                            |
| ----------------------------------- | ---------------------------------- |
| **Authentication**                  | API Key (Header: x-api-key)        |
| **Two-Way Sync**                    | Yes                                |
| **Events Supported**                | Yes (Webhooks)                     |
| **Realtime**                        | Yes (API-based)                    |
| **Supports Rate Limiting**          | Yes                                |
| **Authentication Scopes Supported** | N/A (API key provides full access) |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **Awtomic**:

* **Subscriptions**
* **Customers**
* **Orders**
* **Products**
* **Subscription Plans**
* **Billing Cycles**
* **Payment Methods**
* **Subscription Actions** (pause, resume, skip)

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                                                                                                                               |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Offers free trial?**                             | Awtomic pricing is based on the Shopify store plan. Install from the Shopify App Store at [https://apps.shopify.com/awtomic-subscriptions](https://apps.shopify.com/awtomic-subscriptions) or contact Awtomic for trial information. |
| **Requires requires paid sandbox**                 | No separate sandbox required. You can test with development stores on Shopify.                                                                                                                                                       |
| **Requires partnership to obtain authentication?** | No. Awtomic is a Shopify app, and API credentials are available directly from the app settings.                                                                                                                                      |

***

### Authentication (API Key)

Awtomic uses API Key authentication via the `x-api-key` header.

#### Obtain your Awtomic API Key

1. Install the **Awtomic Subscriptions** app from the Shopify App Store on your Shopify store.
2. Once installed, open the Awtomic app from your Shopify admin panel.
3. Navigate to **Settings** within the Awtomic app.
4. Find the **API Key** section and copy your API key.
5. Enter your API key into Alloy Automation.

#### API Documentation

For detailed API documentation, visit: [https://api.awtomic.com](https://api.awtomic.com) (or contact Awtomic support for API documentation access)

***

## Use Cases

### 1) Subscription order fulfillment

Automatically sync subscription orders from Awtomic to your fulfillment or logistics system, ensuring recurring orders are processed on schedule without manual intervention.

### 2) Customer subscription management

Synchronize subscription data between Awtomic and your CRM, providing customer service teams with complete visibility into subscription status, billing cycles, and payment history.

### 3) Subscription analytics and reporting

Pull subscription metrics, customer lifetime value, and churn data from Awtomic into your business intelligence platform for comprehensive subscription analytics and forecasting.

### 4) Automated subscription workflows

Trigger custom workflows when subscriptions are created, paused, resumed, or canceled—such as sending personalized emails, updating inventory forecasts, or creating support tickets for at-risk customers.

### 5) Payment failure recovery

Monitor failed payments and automatically trigger dunning workflows, alternative payment reminders, or customer outreach to reduce involuntary churn and recover revenue.

***

## API Gotchas

* ⚠️ **Shopify dependency:** Awtomic is built on top of Shopify, so changes to Shopify products or customer data can affect Awtomic subscriptions. Maintain synchronization between both systems.
* ⚠️ **Subscription state management:** Be careful when programmatically modifying subscription states (pause, resume, cancel) as these actions can trigger billing and customer notification workflows.
* ⚠️ **API key security:** The API key provides full access to your Awtomic data. Store it securely and rotate it periodically. Never commit API keys to version control.

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