> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackfront.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

# Integrations

The SDK provides a generic integration data API for third-party services connected through the Stackfront dashboard. Each integration exposes data types that can be queried by slug.

## Usage

```tsx theme={null}
import { useIntegrations } from 'react-native-stackfront-sdk';

function YotpoReviews({ productId }: { productId: string }) {
  const { data, loading } = useIntegrations('yotpo', 'reviews', productId);

  if (loading) return <Loading />;
  if (!data) return null;

  // data.data contains the raw JSON string from the integration
  const reviews = JSON.parse(data.data);

  return <ReviewList reviews={reviews} />;
}
```

## Hook API

```ts theme={null}
function useIntegrations(
  slug: string,      // integration slug, e.g. "yotpo", "klaviyo"
  dataType: string,  // data type, e.g. "reviews", "revenue"
  entityId?: string  // optional entity ID, e.g. productId
): {
  data: IntegrationDataResponse | null;
  loading: boolean;
  error: Error | null;
  refetch: () => Promise<void>;
}
```

## Response Shape

```ts theme={null}
{
  integrationSlug: string;  // e.g. "yotpo"
  dataType: string;         // e.g. "reviews"
  entityId: string;         // e.g. "gid://shopify/Product/123"
  data: string;             // raw JSON string from integration
  syncedAt: string;         // ISO timestamp of last sync
}
```

The `data` field is a raw JSON string — parse it with `JSON.parse()` to access the integration-specific payload.

## Service API

```ts theme={null}
const { integrations } = useStackfront();

const data = await integrations.getData('yotpo', 'reviews', productId);
```

## Connected Integrations

Check which integrations are connected from the SDK config:

```ts theme={null}
const { config } = useStackfront();
const integrations = config?.integrations;
// { "yotpo": { source: "yotpo", connected: true }, ... }
```

## Available Integrations

Available integration slugs depend on what's configured in your Stackfront dashboard. Common integrations include Yotpo, Klaviyo, LoyaltyLion, and Gorgias.