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

# Fairing

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

## Pre-Built Tooling

| Category                            | Details                            |
| ----------------------------------- | ---------------------------------- |
| **Authentication**                  | API Key (Authorization header)     |
| **Two-Way Sync**                    | Yes                                |
| **Events Supported**                | Yes (Webhooks)                     |
| **Realtime**                        | Yes                                |
| **Supports Rate Limiting**          | Yes                                |
| **Authentication Scopes Supported** | N/A (API Key based authentication) |

***

## Objects Supported

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

* **Survey Responses**
* **Questions**
* **Surveys**
* **Attribution Data**
* **Customer Insights**
* **Post-Purchase Survey Results**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                          |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Yes. Fairing offers a free trial for new customers. Sign up at [https://www.fairing.co](https://www.fairing.co) to get started. |
| **Requires requires paid sandbox**                 | No paid sandbox required. You can use your trial account for testing.                                                           |
| **Requires partnership to obtain authentication?** | No. API credentials can be obtained directly from your Fairing account settings.                                                |

***

### Authentication (API Key)

Fairing uses API Key authentication via the Authorization header.

1. Log in to your **Fairing account** at [https://app.fairing.co](https://app.fairing.co).
2. Navigate to **Settings** → **Integrations** or **API Settings**.
3. Generate or copy your **API Key**.
4. Enter your **API Key** into Alloy Automation (typically used in the Authorization header).

#### API Documentation

For detailed API documentation and support, contact Fairing support or visit: [https://www.fairing.co](https://www.fairing.co)

#### Important Notes

* Fairing specializes in post-purchase surveys and customer attribution
* API access allows you to retrieve survey responses and customer insights
* The API key provides access to all survey data in your account
* Keep your API key secure and rotate it periodically for security

***

## Use Cases

### 1) Attribution data collection

Pull post-purchase survey responses from Fairing to understand how customers discovered your brand, enabling better marketing attribution and channel optimization.

### 2) Customer insights aggregation

Sync survey responses and customer feedback into your data warehouse or analytics platform for comprehensive customer behavior analysis.

### 3) Marketing optimization

Use attribution data from Fairing surveys to optimize ad spend across channels by identifying which marketing sources drive the most valuable customers.

### 4) CRM enrichment

Enrich customer profiles in your CRM with survey responses about preferences, interests, and purchase motivations collected through Fairing's post-purchase surveys.

### 5) Product feedback analysis

Collect and analyze product feedback from post-purchase surveys to inform product development, merchandising decisions, and customer experience improvements.

***

## API Gotchas

* **Survey timing:** Fairing surveys are triggered post-purchase. Ensure your integration accounts for the timing delay between order placement and survey completion.
* **Response rates:** Not all customers complete surveys. Your integration should handle cases where survey data is unavailable for certain orders.
* **Data freshness:** Survey responses may not be available immediately after purchase. Implement appropriate polling intervals or use webhooks for real-time updates.
* **Question configuration:** Survey questions can be customized in Fairing. Ensure your integration can handle dynamic question types and response formats.
* **Rate limiting:** Implement rate limiting and exponential backoff to avoid overwhelming the API when syncing large volumes of survey data.

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