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

# Managing partners

> Learn how to recruit, manage, and support your partners

## Partner Lifecycle

Partners in your program go through several stages:

```mermaid theme={null}
flowchart LR
    A[Signup] --> B[Pending]
    B --> C{Review}
    C -->|Approve| D[Active]
    C -->|Reject| E[Rejected]
    D --> F[Archived]
```

### Partner Statuses

| Status        | Description                                  |
| ------------- | -------------------------------------------- |
| **Pending**   | Partner has signed up, awaiting approval     |
| **Active**    | Partner is approved and can earn commissions |
| **Suspended** | Partner is temporarily disabled              |
| **Archived**  | Partner has been removed from the program    |

## Recruiting Partners

### Partner Signup Page

Every program has a public signup page where partners can apply:

```
https://partners.yoursite.com/signup
```

Customize the signup form to collect relevant information:

* Name and email (required)
* Company/website
* Social media profiles
* How they plan to promote

### Invite Partners Directly

Invite specific partners via email:

<Tabs>
  <Tab title="Dashboard">
    1. Navigate to **Partners → Invite**
    2. Enter partner email addresses
    3. Customize the invitation message
    4. Click **Send Invitations**
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST https://api.partnero.com/v1/partners:invite \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "email": "partner@partnero.com",
        "name": "John Doe",
        "send_invitation": true
      }'
    ```
  </Tab>
</Tabs>

### Create Partners Programmatically

Use the API to create partners from your own systems:

```bash theme={null}
curl -X POST https://api.partnero.com/v1/partners \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "partner@partnero.com",
    "name": "John Doe",
    "key": "partner_123",
    "metadata": {
      "source": "website",
      "tier": "gold"
    }
  }'
```

## Managing Partner Details

### Viewing Partner Information

Access detailed partner information from the dashboard:

* **Overview** - Performance metrics and status
* **Referrals** - List of referred leads and customers
* **Transactions** - Sales attributed to the partner
* **Rewards** - Commission history
* **Payouts** - Payment history

### Updating Partners

<Tabs>
  <Tab title="Dashboard">
    1. Go to **Partners** and select a partner
    2. Click **Edit** to modify details
    3. Update fields and save
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X PUT https://api.partnero.com/v1/partners/partner_123 \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "John Smith",
        "metadata": {
          "tier": "platinum"
        }
      }'
    ```
  </Tab>
</Tabs>

## Partner Approval Workflow

### Auto-Approval

Enable auto-approval for all new partners:

1. Go to **Program Settings → Partner Signup**
2. Toggle **Auto-approve new partners**

### Manual Approval

Review each partner application:

1. Navigate to **Partners → Pending**
2. Review partner details and application
3. Click **Approve** or **Reject**

<Tip>
  Use manual approval to vet partners and maintain program quality.
</Tip>

## Partner Tiers & Groups

Organize partners into tiers for different commission rates:

```json theme={null}
{
  "tiers": [
    {
      "name": "Bronze",
      "commission_rate": 15,
      "requirements": null
    },
    {
      "name": "Silver", 
      "commission_rate": 20,
      "requirements": {"min_sales": 10}
    },
    {
      "name": "Gold",
      "commission_rate": 25,
      "requirements": {"min_sales": 50}
    }
  ]
}
```

## Suspending & Archiving Partners

### Suspend a Partner

Temporarily disable a partner (preserves data):

```bash theme={null}
curl -X POST https://api.partnero.com/v1/partners/partner_123/archive \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Restore a Partner

Reactivate a suspended partner:

```bash theme={null}
curl -X POST https://api.partnero.com/v1/partners/partner_123/revoke-archive \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Delete a Partner

Permanently remove a partner:

<Warning>
  Deleting a partner is irreversible and removes all associated data.
</Warning>

```bash theme={null}
curl -X DELETE https://api.partnero.com/v1/partners/partner_123 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Referral Links" icon="link" href="/guides/partner-programs/referral-links">
    Configure partner referral links
  </Card>

  <Card title="Partners API" icon="code" href="/api-reference/partners/list">
    Full API reference for partners
  </Card>
</CardGroup>