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

# PromoStack API Documentation

> Build powerful referral programs for your mobile app

# Welcome to PromoStack

PromoStack is a referral & incentive automation platform for mobile app founders. Automate promo code distribution and get reliable attribution without custom backend infrastructure.

## Quick Start

Get up and running with PromoStack in minutes.

<CardGroup cols={2}>
  <Card title="Quickstart Guide" icon="rocket" href="/quickstart">
    Set up your first referral campaign in 5 minutes
  </Card>

  <Card title="Metacode Flow" icon="link" href="/concepts/metacode-flow">
    Learn how PromoStack ensures reliable attribution
  </Card>
</CardGroup>

## API Integration

Integrate PromoStack into your mobile app with our simple REST API.

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Get your API key and authenticate requests
  </Card>

  <Card title="Referrer API" icon="user-plus" href="/api-reference/referrer">
    Get or create referrer and track progress
  </Card>

  <Card title="Referee Redeem" icon="gift" href="/api-reference/referee-redeem">
    Redeem a metacode and get platform-specific promo code
  </Card>
</CardGroup>

## Core Features

* **Metacode System**: Reliable attribution independent of RevenueCat
* **Multi-Platform**: iOS and Android support out of the box
* **Anti-Fraud**: Built-in duplicate detection
* **Real-Time Progress**: Track referrals and rewards instantly
* **RevenueCat Integration**: Automatic webhook processing