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

# Grin

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

## Pre-Built Tooling

| Category                            | Details                                                 |
| ----------------------------------- | ------------------------------------------------------- |
| **Authentication**                  | Bearer Token (API Key)                                  |
| **Two-Way Sync**                    | No                                                      |
| **Events Supported**                | No                                                      |
| **Realtime**                        | No (Polling)                                            |
| **Supports Rate Limiting**          | Yes                                                     |
| **Authentication Scopes Supported** | N/A (API key-based authentication provides full access) |

***

## Objects Supported

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

Grin's OpenAPI specification defines various endpoints for managing influencer relationships, campaigns, and performance metrics. Objects typically include:

* **Influencers**
* **Campaigns**
* **Products**
* **Orders**
* **Content**
* **Analytics**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                                                    |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Contact Grin for a demo at [https://grin.co/request-demo/](https://grin.co/request-demo/). Free trial availability varies based on business requirements. |
| **Requires paid sandbox?**                         | No dedicated sandbox environment. Testing is typically done in your production account with test data.                                                    |
| **Requires partnership to obtain authentication?** | No. API access is available to Grin customers.                                                                                                            |

***

### Authentication (API Key)

Grin uses API key authentication with Bearer token format.

#### Obtain your API key

1. Log in to your Grin account at [https://app.grin.co](https://app.grin.co)
2. Navigate to **Settings** → **Integrations** or **API Settings**
3. Look for the **API Access** or **API Token** section
4. Click **Generate API Key** or **Create New Token**
5. Provide a descriptive name for your API key (e.g., "Alloy Automation Integration")
6. Copy the generated **API Key**
7. **Important**: Store the API key securely—it provides full access to your Grin account
8. The API key should be used as a Bearer token in the Authorization header: `Authorization: Bearer YOUR_API_KEY`

#### Additional configuration

* API keys have full access to your Grin account data
* You can generate multiple API keys for different integrations
* Revoke any API keys that are no longer needed or have been compromised
* Test your API key with a simple GET request to verify authentication

#### Getting Started

* **Grin Website**: [https://grin.co/](https://grin.co/)
* **Request Demo**: [https://grin.co/request-demo/](https://grin.co/request-demo/)
* **API Documentation**: [https://help.grin.co/docs/integrating-with-the-grin-api](https://help.grin.co/docs/integrating-with-the-grin-api)
* **Help Center**: [https://help.grin.co/](https://help.grin.co/)

***

## Use Cases

### 1) Influencer relationship management

Sync influencer profiles, contact information, and engagement metrics from Grin to your CRM or data warehouse, enabling comprehensive tracking of influencer relationships and performance across your marketing stack.

### 2) Campaign performance tracking

Automatically pull campaign results, ROI metrics, and content performance data into your analytics platform to measure influencer marketing effectiveness alongside other marketing channels.

### 3) Product seeding automation

Integrate Grin with your inventory management system to automate product shipments to influencers, track seeding campaigns, and monitor which products generate the most authentic content.

### 4) Content rights management

Extract influencer-generated content metadata and usage rights from Grin to populate your digital asset management system, ensuring proper tracking of content licensing and usage permissions.

### 5) Commission and payment workflow

Sync order data, commission calculations, and payment status between Grin and your financial systems to streamline influencer payment processing and maintain accurate financial records.

***

## API Gotchas

* **Rate limiting**: Grin implements rate limits on API requests to ensure system stability. Monitor your request volume and implement appropriate throttling to avoid 429 responses. Contact Grin support if you need higher rate limits.

* **Authentication errors**: If you receive authentication errors, verify that your API key is correctly formatted with the Bearer prefix and hasn't been revoked. API keys don't expire automatically but can be manually revoked in settings.

* **Data sync delays**: When syncing large amounts of historical data, be aware that Grin's API may return paginated results. Implement proper pagination handling to ensure you retrieve all records.

* **Limited documentation**: Grin's public API documentation may be less comprehensive than other platforms. For specific endpoint details or advanced use cases, contact Grin's support team or your account manager for assistance.

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