# Skool + n8n Integration Setup Guide

**Purpose**: Automatically sync new Skool community members to your email list
**Method**: Unofficial API method (educational purposes only)
**VPS**: ai-termimal
**Created**: 2025-11-29

## Overview

This integration watches for new members in your Skool community and automatically adds them to your email marketing platform. Since Skool doesn't provide an official API, this uses HTTP requests to mimic the member export functionality.

**Important Disclaimers:**
- This is an **unofficial method** and may stop working if Skool changes their system
- Use for **educational purposes only**
- This method requires extracting authentication tokens from your browser

## How It Works

1. **Schedule Trigger**: Runs every 2 hours (configurable)
2. **Export Member List**: Makes HTTP request to export members as CSV
3. **Get Download URL**: Extracts the file download link
4. **Download CSV**: Retrieves the member list file
5. **Parse CSV**: Extracts member data
6. **Limit Results**: Takes only the top N members (based on expected new joins)
7. **Check & Add**: Loops through members and adds new ones to your email list

## Architecture

```
Schedule (2hrs) → Export Request → Get File URL → Download CSV → Parse Data
                                                                      ↓
Email Platform ← Add New Member ← Check if Exists ← Limit Top N ← Extract
```

## Prerequisites

- n8n instance running (cloud or self-hosted)
- Skool community with admin access
- Email marketing platform account (ConvertKit, Mailchimp, etc.)
- Chrome/Firefox browser for extracting authentication tokens

## Key Components

### 1. Schedule Trigger
- **Interval**: 2 hours (adjust based on your needs)
- **Logic**: More frequent = lower limit needed, less frequent = higher limit

### 2. Authentication Requirements

You'll need to extract these from your browser:

- **Cookie** (from request headers)
- **X-AWS-WAF-Token** (from request headers)
- **User-Agent** (from request headers)
- **URL parameters** (expires, signature, key-pair-id)

### 3. HTTP Nodes Configuration

**Node 1 - Export Request:**
- Method: POST
- URL: `https://api.school.com/request-bulk-action`
- Query Parameters:
  - `type`: `bulk-export-csv`
  - `all-members-selected`: `true`
  - `members-status`: `active`

**Node 2 - Get Download URL:**
- Method: GET
- URL: `https://api.school.com/files/{fileId}/download-url`

**Node 3 - Download File:**
- Method: GET
- URL: From previous step's data field
- Query Parameters: expires, signature, key-pair-id

### 4. Member Limit Calculation

**Critical Logic:**
- If automation runs every 2 hours and you expect max 15 new members per 2 hours → Set limit to 15
- If automation runs every 6 hours and you expect max 50 new members per 6 hours → Set limit to 50
- This prevents checking all members (which could be thousands) every time

### 5. Email Integration

The workflow checks if each member exists in your email platform:
- **If exists**: Skip (continue to next member)
- **If new**: Add to email list and tag appropriately

## Rate Limiting Considerations

- **n8n pricing advantage**: Much cheaper than Zapier for high-volume operations
- **Execution frequency**: Balance between timeliness and resource usage
- **Member limit**: Prevents unnecessary API calls to email platform

## Next Steps

See `ai-termimal-skool-n8n-detailed-setup.md` for step-by-step implementation instructions.

## Troubleshooting

### Common Issues

1. **Authentication Fails**: Tokens expire, need to re-extract from browser
2. **No Members Found**: Check limit value and sort order in CSV
3. **Duplicate Members**: Adjust schedule frequency or limit value
4. **CSV Download Fails**: Re-extract AWS WAF token and cookies

### Token Expiration

- Cookies and tokens expire periodically
- You'll need to re-extract them when the workflow fails
- Consider monitoring workflow for failures

## Related Files

- `ai-termimal-skool-n8n-detailed-setup.md` - Step-by-step setup instructions
- `ai-termimal-skool-workflow-template.json` - n8n workflow template
- `ai-termimal-skool-config-reference.md` - Configuration parameter reference

## Credits

Based on tutorial by Sant Kala: https://www.youtube.com/watch?v=vZaYYzb4y5Y