PopUp Organizer

# PopUp Organizer

Search and hire mobile vendors — food trucks, DJs, photo booths, florists, live bands, and more — for any event. Create event listings, send booking inquiries, manage applications, track invoices, and save favorite vendors.

---

## Getting Started

1. Sign up or log in at <https://usepopup.com/login>
2. Switch to **Organizer** mode
3. Go to **Settings > API Keys**
4. Click **Create API Key** and copy the key (shown only once)

---

## Authentication

All requests require a Bearer token in the `Authorization` header:

```
Authorization: Bearer pk_live_...
```

The token is provided via the `POPUP_API_KEY` environment variable.

**Rate limit:** 60 requests per minute per API key. HTTP 429 is returned with `Retry-After: 60` if exceeded.

**Base URL:** `https://usepopup.com/api/v1/organizer`

---

## Endpoints

### Search Vendors

`GET /vendors`

Search published vendor profiles by name, type, location, event type, or price range.

| Param | Type | Description |
|-------|------|-------------|
| `q` | string | Search query (name, type, city, description) |
| `type` | string | Vendor category — see categories below |
| `state` | string | 2-letter US state code (e.g. `CA`, `NY`) |
| `metro` | string | Metro area within state (requires `state`) |
| `event` | string | Event type filter — see event types below |
| `price` | string | Price range: `$`, `$$`, `$$$`, `$$$$` |
| `sort` | string | `newest`, `name_asc`, `name_desc`, `rating` |
| `page` | number | Page number (default 1) |
| `limit` | number | Results per page (default 20, max 100) |

Returns vendor profiles with `businessName`, `businessType`, `homeCity`, `homeState`, `priceRange`, `averageRating`, `eventTypes`, `slug`, and more.

---

### List Events

`GET /open-events`

List your events.

| Param | Type | Description |
|-------|------|-------------|
| `status` | string | Filter: `open`, `closed`, `canceled` |
| `page` | number | Page number |
| `limit` | number | Results per page |

Returns eve...

# ClawHub Skill — PopUp Organizer

This directory contains the ClawHub skill definition for the PopUp organizer API — searching vendors, managing events, sending booking inquiries, and tracking invoices.

**Scope:** Full organizer API access — vendor search, event CRUD, inquiry management, invoices, saved vendors, profile management. Does not include referral program features (see `clawhub-skill/` for that).

## Publishing

### 1. Authenticate (one-time)

```bash
npx clawhub@latest auth login --token "clh_..." --no-browser --registry "https://www.clawhub.ai/"
```

Replace `clh_...` with your actual CLI token.

### 2. Publish

```bash
npx clawhub@latest publish ./clawhub-organizer \
  --slug popup-organizer \
  --name "PopUp Organizer" \
  --version 1.0.0 \
  --changelog "Initial release: vendor search, event management, inquiries, invoices, saved vendors, profile" \
  --tags "events,vendors,food-trucks,marketplace,booking,invoicing,organizer"
```

### 3. Verify

```bash
npx clawhub@latest info popup-organizer
```

## Updating

```bash
npx clawhub@latest publish ./clawhub-organizer \
  --slug popup-organizer \
  --name "PopUp Organizer" \
  --version 1.1.0 \
  --changelog "Description of changes" \
  --tags "events,vendors,food-trucks,marketplace,booking,invoicing,organizer"
```