Settings reference
Everything you can change in the Settings tab, what it does, and the default we ship.
Changes take effect on the very next tick — no restart, no waiting. Sensitive values (passwords, API keys, tokens) are encrypted at rest in your workspace.
Inbox (IMAP)
Section titled “Inbox (IMAP)”Where Tickong reads ticket confirmations from.
| Setting | Default | Notes |
|---|---|---|
| Host | — | e.g. imap.gmail.com |
| Port | 993 | |
| TLS | on | Leave on unless your provider doesn’t support it |
| User | — | Full email address |
| Password | — | App password (Gmail/iCloud/Outlook). Not your account password. |
| Pending folder | INBOX | Where Tickong looks for new mail |
| Processed folder | Tickong/Processed | Where parsed messages move to |
| Skipped folder | Tickong/Skipped | Where pre-filtered or duplicate messages move to |
| Failed folder | Tickong/Failed | Where errored messages land — investigate from the Activity tab |
Gmail labels and IMAP folders are the same thing — Tickong/Processed becomes a nested label.
Notion
Section titled “Notion”Where parsed tickets get written.
| Setting | Notes |
|---|---|
| Integration secret | The “Internal Integration Secret” from your Notion integration page |
| Database ID | The 32-char hex string from your Notion DB URL |
See Notion database setup for the schema and how to get these values.
Polling
Section titled “Polling”| Setting | Default | Notes |
|---|---|---|
| Poll interval | 2 min | How often Tickong checks for new mail and detects sales. Lower means faster pickup but more inbox traffic. |
Pre-filter
Section titled “Pre-filter”A free check that runs before Claude. It drops anything that doesn’t look like a ticket purchase, saving on AI costs.
| Setting | Notes |
|---|---|
| Disabled | Off by default. Turn on to send every email to Claude — useful only when debugging a missed confirmation. |
| Extra senders | Comma-separated fragments to additionally allow (case-insensitive substring match) |
| Extra subjects | Comma-separated subject keywords to additionally allow |
Built-in coverage: Ticketmaster, FIFA, AXS, StubHub, Viagogo, SeatGeek, Eventbrite, See Tickets, Vivid Seats, Dice, Ticombo, Fansale, Entradas.com, Entradium, Tomaticket, El Corte Inglés, Fever, Wegow, RedTKT, Real Madrid, Barcelona, Atlético, RFEF, UEFA — and English / Spanish / Portuguese / French / German purchase-confirmation phrasings.
If a real ticket email is being skipped, copy a fragment from its From: header into Extra senders.
Vivid SkyBox auto-list
Section titled “Vivid SkyBox auto-list”Optional. When enabled, every primary-platform purchase that lands in Notion gets auto-listed for resale on SkyBox.
| Setting | Default | Notes |
|---|---|---|
| Enabled | off | Master switch |
| X-Account header | — | From SkyBox |
| API token | — | SkyBox → Settings → External Accounts |
| Application token | — | From https://skybox.vividseats.com/application-sign-up |
| Vendor ID | — | Your SkyBox vendor ID |
| Stock type | Mobile transfer | One of: Mobile transfer, Electronic, Hard, Flash Seats |
| Split type | Any | One of: Any, Default, Custom, Never leave one |
| Delivery method | Mobile delivery | One of: Mobile delivery, eTicket, Flash Seats, Guest list, Will call |
| Broadcast on creation | on | Whether new listings go live on the Vivid marketplace immediately |
| Dry run | off | Log what would be listed without hitting the API. Useful when testing. |
| Auto-list platforms | Ticketmaster, FIFA, AXS, Eventbrite, SeeTickets | Only auto-list when the parsed platform is in this list. Skip secondary marketplaces (StubHub, Viagogo, Vivid Seats) — those are sales of inventory you already had. |
Pricing
Section titled “Pricing”| Setting | Default | Notes |
|---|---|---|
| Pricing enabled | off | When off, every listing uses Default price (or a placeholder $9999 listing if the default is 0) |
| Default price | $0 | Used when pricing is disabled |
| Strategy | Undercut | One of: Undercut the cheapest, Percent below market, Fixed amount |
| Undercut amount | $5 | Dollars below the cheapest comparable listing (when strategy = Undercut) |
| Percent below | 5% | Percentage below the cheapest comparable listing (when strategy = Percent below) |
| Fixed price | $0 | Used when strategy = Fixed |
| Floor multiplier | 1.10 | Hard floor — never list below cost × multiplier. 1.10 means at least 10% margin. |
| Section match | Any | Any compares against the whole event; Exact only against your section |
Full pricing logic with worked examples: Vivid SkyBox → Pricing.
Sales detection
Section titled “Sales detection”After every tick’s email loop, Tickong asks SkyBox for your active inventory and diffs it against the previous tick’s snapshot. Anything that disappeared gets logged as a sale.
| Setting | Default | Notes |
|---|---|---|
| Enabled | on | |
| Notion writeback | off | If you’ve added a writable Sold At / Sale Price property to your Notion DB, Tickong can update it when a sale is detected. Off by default since the standard schema uses formula-only Status fields that aren’t writable. |
Read Sales tracking for the mechanics.
Pulls (multi-buyer)
Section titled “Pulls (multi-buyer)”If you “pull” tickets for other people (split a 4-pack with 3 friends, take orders from clients, etc.), use the Pulls tab to assign each ticket to a buyer with their own profit split and payment ledger.
There are no settings here — buyers are managed inside the Pulls tab via Manage buyers. Each buyer has its own profit-split percentage and a per-buyer “owed” balance computed from their realised profit minus payments you’ve recorded.
Sale notifications (webhooks)
Section titled “Sale notifications (webhooks)”Get pinged in Discord, Slack, or any HTTP endpoint when a sale is detected.
| Setting | Notes |
|---|---|
| Webhook URL | Where to POST. Empty disables webhooks. |
| Webhook secret | Optional. When set, Tickong includes an HMAC-SHA256 signature header so your endpoint can verify requests came from Tickong. |
Tickong auto-detects the destination from the URL:
- Discord webhook URLs get a styled embed (profit-coloured stripe, event title, seat block, cost/list/profit field).
- Slack incoming webhook URLs get a structured message with header + 6-cell grid.
- Anything else gets a generic JSON payload (
event,timestamp,sale).
There’s a Test webhook button — it fires a sample sale at your URL and reports back the receiver’s response so you can confirm formatting works.
Account
Section titled “Account”| Setting | Notes |
|---|---|
| Workspace name | What you call this Tickong workspace. Shown in the top toolbar. |
| The address you signed up with. Used for verification and password reset. | |
| Password | Change with Reset password — sends a reset link to your verified email. |
Editing settings
Section titled “Editing settings”Go to Settings, change a value, click Save settings. The next tick (within 2 min by default) will use the new value.
If you want to apply a setting immediately without waiting for the next tick, click Run once in the top toolbar after saving.