# Send PopUp Organizer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "popup-organizer",
    "name": "PopUp Organizer",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/eliaskress/popup-organizer",
    "canonicalUrl": "https://clawhub.ai/eliaskress/popup-organizer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/popup-organizer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=popup-organizer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/popup-organizer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/popup-organizer",
    "downloadUrl": "https://openagent3.xyz/downloads/popup-organizer",
    "agentUrl": "https://openagent3.xyz/skills/popup-organizer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/popup-organizer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/popup-organizer/agent.md"
  }
}
```
## Documentation

### 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

Sign up or log in at https://usepopup.com/login
Switch to Organizer mode
Go to Settings > API Keys
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

### Search Vendors

GET /vendors

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

ParamTypeDescriptionqstringSearch query (name, type, city, description)typestringVendor category — see categories belowstatestring2-letter US state code (e.g. CA, NY)metrostringMetro area within state (requires state)eventstringEvent type filter — see event types belowpricestringPrice range: $, $$, $$$, $$$$sortstringnewest, name_asc, name_desc, ratingpagenumberPage number (default 1)limitnumberResults 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.

ParamTypeDescriptionstatusstringFilter: open, closed, canceledpagenumberPage numberlimitnumberResults per page

Returns events with title, eventDate, startTime, endTime, eventCity, eventState, vendorCap, expectedGuestCount, status, shareUrl, shortUrl, and qrCodeUrl.

### Get Event Detail

GET /open-events/{eventId}

Returns the event object plus an applications array (each with businessId, status, quotedRate, engagementModel, and nested business info) and eventTerms.

### Create Event

POST /open-events

Create a new event listing.

Required fields: title, description, eventType, eventDate (YYYY-MM-DD), startTime (HH:mm), endTime (HH:mm), eventPlaceName, eventAddress1, eventCity, eventState (2-letter), eventZip, vendorCap (1-1000), feePayer (organizer_pays | vendor_pays | none), expectedGuestCount (1-100000), vendorCategoriesWanted (array, 1-20 items).

Optional fields: location, eventLat, eventLng, heroImageUrl, organizerBudget, boothFee, salesPercent, hiredBudget, venueSetting, requiresVerification, invoiceDueDays, termIds.

Events are pending admin approval before becoming publicly visible.

### Update Event

PATCH /open-events/{eventId}

Update event fields or perform actions.

Actions: { "action": "close" } to close to new applications, { "action": "reopen" } to reopen.

Updatable fields: all the same fields as create. When key details change (date, time, venue, title), accepted vendors are notified.

### Cancel Event

DELETE /open-events/{eventId}

Cancel an event. All pending and accepted vendors are notified.

### List Applications

GET /open-events/{eventId}/applications

List vendor applications for an event.

ParamTypeDescriptionstatusstringFilter: pending, accepted, declined, withdrawnpagenumberPage numberlimitnumberResults per page

### Get Event QR Code

GET /open-events/{eventId}/qr

Returns a PNG QR code image for the event share link.

### List Inquiries

GET /inquiries

List your inquiries to vendors.

ParamTypeDescriptionstatusstringFilter: pending, quoted, booked, declinedpagenumberPage numberlimitnumberResults per page

Returns inquiries with eventDate, eventType, guestCount, location, budget, message, status, quotedPrice, quoteMessage, and nested business info.

### Get Inquiry Detail

GET /inquiries/{id}

Get a single inquiry with full detail.

### Create Inquiry

POST /inquiries

Send a booking inquiry to a vendor.

Required: businessId (UUID).

Optional: bookingType (catering | vending), eventDate (YYYY-MM-DD), eventType, guestCount, location, eventPlaceName, eventAddress1, eventCity, eventState, eventZip, budget, message, phone, startTime (HH:mm), endTime (HH:mm), estimatedPrice.

The vendor is notified by email and in-app notification.

### Update Inquiry

PATCH /inquiries/{id}

Update a pending inquiry or respond to a quote.

Actions: { "action": "accept_quote" } (inquiry must be quoted), { "action": "decline" } (inquiry must be quoted).

Updatable fields (pending only): eventDate, eventType, guestCount, location, budget, message, startTime, endTime.

### Delete Inquiry

DELETE /inquiries/{id}

Delete a pending inquiry. Only works on status=pending.

### List Invoices

GET /invoices

List invoices for event applications and direct inquiries.

ParamTypeDescriptionpagenumberPage numberlimitnumberResults per page

Returns invoices with eventTitle, eventDate, vendorName, engagementModel, amount (dollars), direction (receivable | payable), isPaid.

### List Saved Vendors

GET /saved

List your bookmarked vendors.

### Save Vendor

POST /saved

Bookmark a vendor: { "businessId": "..." }

### Remove Saved Vendor

DELETE /saved?businessId=...

Remove a bookmarked vendor.

### Get Profile

GET /profile

Get your organizer profile and account info.

### Update Profile

PATCH /profile

Update your organizer profile.

Fields: companyName, companyType (brand | agency | planner | corporate), eventTypes (array), location, city, state, zip, phone, website, about, givesBack, nonProfit, forACause, rules.

### Response Format

All endpoints return JSON with { "data": ... } wrapper. List endpoints include { "pagination": { "page", "limit", "total", "totalPages" } }.

Error responses: { "error": "message" } with appropriate HTTP status (400, 401, 404, 429, 500).

### Vendor Categories

Use these values for the type parameter when searching vendors:

ValueLabelfood_truckFoodbakeryBakery / DessertsbeverageBeverage / Coffee / BardjDJ / Entertainmentphoto_boothPhoto BoothphotographyPhotographylive_bandLive MusicfloristFlorist / Event FloralsballoonsBalloons / Balloon DecoryogaWellnessarts_craftsRetail VendorotherOther

### Event Types

Use these values for eventType fields:

wedding, corporate, birthday, festival, market, popup, fundraiser, community, holiday, private, other
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: eliaskress
- Version: 2.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/popup-organizer)
- [Send to Agent page](https://openagent3.xyz/skills/popup-organizer/agent)
- [JSON manifest](https://openagent3.xyz/skills/popup-organizer/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/popup-organizer/agent.md)
- [Download page](https://openagent3.xyz/downloads/popup-organizer)