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

# Junip

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

## Pre-Built Tooling

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

* Custom actions and resources (refer to Junip API documentation for available endpoints)

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                      |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Contact Junip for trial access information at [https://juniphq.com/](https://juniphq.com/). |
| **Requires paid sandbox**                          | Unknown. Contact Junip sales for sandbox availability.                                      |
| **Requires partnership to obtain authentication?** | No, but you must be a Junip customer.                                                       |

***

### Authentication (API Key)

Junip uses API Key authentication passed via the `Junip-Store-Key` header.

#### How to obtain your API Key

1. **Log in to your Junip account** at [https://app.juniphq.com](https://app.juniphq.com)
2. Navigate to **Settings** in your Junip dashboard
3. Look for the **API** or **Integrations** section
4. **Generate a new API Key** or copy your existing store key
5. Store this key securely - it will be used as the `Junip-Store-Key` header
6. **Configure the API Key in Alloy Automation**:
   * Header name: `Junip-Store-Key`
   * Header value: Your generated store API key

#### API Documentation

* Junip API Base URL: [https://api.juniphq.com/](https://api.juniphq.com/)
* For detailed API documentation, contact Junip support or check their developer portal

***

## Use Cases

### 1) Review data synchronization

Sync customer reviews and ratings from Junip to your e-commerce platform, marketing tools, or data warehouse to leverage social proof across your entire marketing stack.

### 2) Automated review request workflows

Trigger automated review request campaigns when orders are fulfilled or delivered, using data from your order management system to identify eligible customers.

### 3) Product feedback analysis

Pull review data into analytics platforms to analyze product feedback, identify trends, and inform product development decisions based on customer sentiment.

### 4) UGC content distribution

Distribute user-generated content (reviews, photos, ratings) from Junip to social media platforms, email campaigns, or product pages to maximize the impact of customer testimonials.

### 5) Customer sentiment tracking

Integrate Junip review data with customer success platforms to track customer satisfaction trends, identify at-risk customers, and proactively address concerns.

***

## API Gotchas

* **Limited public documentation**: Junip's API documentation may not be publicly available. Work directly with Junip support to understand available endpoints, request/response formats, and rate limits.
* **Store key security**: The `Junip-Store-Key` header grants access to your store's review data. Never expose this key in client-side code, public repositories, or version control. Rotate keys regularly and revoke compromised keys immediately.
* **Custom action configuration**: Since Junip is marked with `x-alloy-custom-action: true`, you'll need to work with Alloy Automation support to configure custom API calls for your specific Junip integration needs.
* **Base URL**: Ensure you're using the correct base URL (`https://api.juniphq.com/`) for all API requests. Some features may use different endpoints or API versions.
* **Response handling**: Without detailed schema information, thoroughly test your integration to ensure proper parsing of API responses. Review data structures may vary based on your Junip account configuration.
* **Rate limiting**: While rate limits are supported, specific limits are not documented in the OpenAPI spec. Monitor your API usage and implement exponential backoff to handle potential rate limiting scenarios.

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