swag-pending-approvals

name

swag-pending-approvals

description

Check Swag.com referral-program campaigns for orders pending approval. Runs referral fraud checks on each pending order and includes approve/deny recommendations. Shows redeemed orders awaiting shipment approval with name, email, tier, and location, and posts a Slack summary to a configured channel. Use when the user asks for "pending swag approvals", "swag orders to approve", "referral program approvals", or "check swag".

Swag Pending Approvals

Check your Referral Program campaigns on Swag.com for orders in "received" status — the recipient has redeemed their giveaway link and submitted shipping info, but the order hasn't been approved yet.

Prerequisites

• SWAG_API_KEY — Swag.com API key (HTTP Basic Auth username).
• BUZZ_SLACK_TOKEN — Slack bot token (only for sending).
• APPROVALS_CHANNEL_ID — Slack channel to post the summary to.

API reference

https://api-docs.swag.com/ — Swag Pro API v2. Auth is HTTP Basic with the API key as username, no password. Base URL: https://api.swag.com/v2/.

Configuring campaigns

List your Referral Program campaign IDs and their tier labels in a local config or environment variable (do not commit real campaign IDs). Example shape:

REFERRAL_CAMPAIGNS = {
    # campaign_id: "tier label"
    111111: "5 Tier",
    222222: "10 Tier",
    # ...
}

Dashboard URL pattern: https://pro.swag.com/account/campaign/overview.php?storeid=<campaign_id>

Workflow

Step 1: Fetch pending orders

Query each campaign for orders with status , using the filter to avoid paging through all orders.