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

# Integrations Overview

> Connect Fanaura with third-party services to unlock SMS, Instagram DMs, native notification pre-saves, and more.

Fanaura becomes more powerful with every service you connect. Integrations let you automate Instagram DMs, send SMS campaigns through your own phone number, enable Spotify and Apple Music presaves, and much more. This page gives you a bird's-eye view of everything available and how to get started.

<Frame caption="The Integrations page showing all available third-party connections and their status.">
  <img src="https://mintcdn.com/fanaurainc/RnYfBYSFirNGTEEw/images/integrations.png?fit=max&auto=format&n=RnYfBYSFirNGTEEw&q=85&s=aececff2757e60f797b61fdd2e018014" alt="Fanaura Integrations Page" width="2880" height="1800" data-path="images/integrations.png" />
</Frame>

## How to Access Integrations

You can reach the Integrations page two ways:

<Steps>
  <Step title="Via Sidebar">
    Click **Integrations** in the left sidebar navigation.
  </Step>

  <Step title="Via Settings">
    Click **Settings** (gear icon), then select the **Integrations** tab.
  </Step>
</Steps>

Both routes take you to the same page.

## Available Integrations

<CardGroup cols={2}>
  <Card title="SMS" icon="comment-sms" href="/integrations/sms">
    Provision a **local 10DLC** number for 2-way SMS, blasts, and flows. Throughput is batched per minute based on your line's configured rate and carrier rules.
  </Card>

  <Card title="Instagram" icon="instagram" href="/integrations/instagram">
    Automate Instagram DMs, comment-to-DM triggers, story responses, and keyword-based flow automation.
  </Card>

  <Card title="Spotify" icon="music" href="/integrations/spotify">
    Artist search and metadata lookup (read-only). Pre-saves use native notification, not Spotify OAuth.
  </Card>

  <Card title="Apple Music" icon="headphones" href="/integrations/apple-music">
    Platform selection for native notification pre-save on release day.
  </Card>

  <Card title="Streaming Platforms" icon="headphones" href="/integrations/streaming-platforms">
    All 9+ DSPs for presaves and streaming links including YouTube Music, Tidal, Deezer, and more.
  </Card>

  <Card title="MasterTour" icon="bus" href="/integrations/mastertour">
    Sync tour dates and booking data from MasterTour into Fanaura. Coming soon.
  </Card>
</CardGroup>

## Integration Categories

### Messaging

Connect communication channels to reach fans directly.

| Integration | What It Does | Status |
| - | - | - |
| **SMS** | Provision your own phone number for 2-way SMS with fans | Available |
| **Instagram** | Automate Instagram DMs, comment triggers, story responses | Available |

### Music

Connect streaming and music platforms for presaves and analytics.

| Integration | What It Does | Status |
| - | - | - |
| **Spotify** | Enable presaves, artist search, streaming metadata | Available |
| **Apple Music** | Enable presaves via MusicKit | Available |
| **9 Additional DSPs** | Streaming links for YouTube Music, Amazon Music, Tidal, Deezer, Pandora, SoundCloud, Audiomack | Available |

### Touring

Connect tour management platforms for booking and venue data.

| Integration | What It Does | Status |
| - | - | - |
| **MasterTour** | Sync tour dates and booking data | Coming Soon |

### Merch (no store API)

Merch is managed in **Assets > Merch** — add a title, image, and external **https** product link. Fanaura does not connect to e-commerce platforms via API. See [Adding Merch](/assets/merch/adding-merch).

## Integration Status Indicators

On the Integrations page, each service shows its current connection status:

* **Connected** (green): The integration is active and working.
* **Not Connected** (grey): The integration is available but not yet set up.
* **Coming Soon** (badge): The integration is planned but not yet available.
* **Error** (red): Something went wrong. Click to view details and troubleshoot.

## What Each Integration Unlocks

Connecting an integration opens new capabilities throughout Fanaura:

<Tabs>
  <Tab title="SMS">
    * Send SMS blasts to opted-in fans
    * Add SMS actions to your flows
    * 2-way fan conversations in the Fans page
    * SMS campaign sending (batched per your number's messages-per-minute setting)
  </Tab>

  <Tab title="Instagram">
    * Trigger flows when fans DM you specific keywords
    * Auto-DM fans who comment on your posts, reels, or lives
    * Respond to story mentions and replies
    * Send Instagram DMs through flow actions
  </Tab>

  <Tab title="Spotify">
    * Fans can presave your upcoming releases
    * Artist metadata auto-fills during music ingestion
    * Presave-to-stream conversion tracking
    * Artwork and song data imported automatically
  </Tab>

  <Tab title="Apple Music">
    * Fans can presave on Apple Music alongside Spotify
    * Songs are added to their library on release day
    * Broadens your presave reach to Apple's audience
  </Tab>
</Tabs>

## Setup Process

Each integration has its own setup flow, but they generally follow the same pattern:

<Steps>
  <Step title="Navigate">
    Go to the Integrations page.
  </Step>

  <Step title="Select">
    Click the integration you want to connect.
  </Step>

  <Step title="Authorize">
    Authorize via OAuth (for Instagram, Spotify) or follow the provisioning flow for SMS.
  </Step>

  <Step title="Configure">
    Adjust any settings specific to that integration.
  </Step>

  <Step title="Verify">
    Confirm the connection is active (green status).
  </Step>
</Steps>

Detailed setup guides for each integration are available in the pages linked above.

## Disconnecting Integrations

If you need to disconnect a service:

<Steps>
  <Step title="Open Integrations">
    Go to the Integrations page.
  </Step>

  <Step title="Select the Integration">
    Click on the connected integration.
  </Step>

  <Step title="Disconnect">
    Click **Disconnect** and confirm the action.
  </Step>
</Steps>

<Warning>
  Before disconnecting, check if any active flows rely on that integration. Pause those flows first to avoid errors.
</Warning>

**What happens when you disconnect**:

* The integration stops syncing data.
* Existing data (fan interactions, etc.) is preserved in Fanaura.
* Flows using that integration's actions will not be able to send (those actions will error).
* You can reconnect at any time.

## Permissions and Access

Not all team members can manage integrations:

| Role | Can View | Can Connect/Disconnect |
| - | - | - |
| Account Owner | Yes | Yes |
| Admin | Yes | Yes |
| Manager | Yes | Yes |
| All other roles | No | No |

## Best Practices

<Tip>
  **Connect integrations before your first launch.** The more integrations you have active, the more data Fanaura collects from every fan interaction.
</Tip>

<Tip>
  **Start with your highest-priority channel.** If Instagram is where your fans engage most, connect Instagram first. If SMS is your primary communication channel, start with SMS provisioning.
</Tip>

<Note>
  **Test after connecting.** After each integration, run a quick test — send a test SMS or verify Instagram webhook delivery.
</Note>

<Warning>
  **Keep credentials secure.** API keys and tokens are stored securely in Fanaura, but never share them in public channels (Slack, email) or with people who do not need them.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.