Skip to content
tickong/docs

Getting Started

From sign-up to your first parsed ticket in about 5 minutes.

Before you start

Section titled “Before you start”

You’ll need three things:

WhatWhy
A dedicated email inboxTickong reads ticket confirmations from here. Use a fresh Gmail (or any IMAP inbox) — not your personal one.
A Notion workspaceHolds the parsed tickets. You’ll create one database with the right properties.
(Optional) A Vivid SkyBox accountOnly if you want auto-listing. You can skip this and add it later.

If you don’t have a dedicated inbox yet, create a free Gmail address first — something like tickets@yourdomain.com or yourname.tickets@gmail.com. Forward your ticket purchase confirmations to it.

1. Create your Tickong workspace

Section titled “1. Create your Tickong workspace”

Go to https://tick.ong/login and click the Create account tab.

Pick a workspace name, an email, and a password (8+ characters). You’ll get a verification email — click the link to activate the workspace.

Once verified, you land on a three-step onboarding wizard at /onboard:

  1. Connect your inbox (IMAP)
  2. Connect your Notion database
  3. Connect Vivid SkyBox (optional — you can click Skip for now)

Each step has a Test connection button that runs against your real credentials. If something is wrong, the wizard tells you immediately so you can fix it before continuing.

2. Set up the email inbox

Section titled “2. Set up the email inbox”

If you’re using Gmail

Section titled “If you’re using Gmail”
  1. Turn on 2-Step Verification at https://myaccount.google.com/security.
  2. Generate an App Password at https://myaccount.google.com/apppasswords. Pick “Mail” and “Other (Custom name)” — call it “Tickong”. Copy the 16-character password.
  3. In the Tickong onboard wizard, paste:
    • Host: imap.gmail.com
    • Port: 993
    • TLS: on
    • User: your Gmail address
    • Password: the 16-character app password (not your normal Gmail password)

If you’re using something else

Section titled “If you’re using something else”

Tickong works with any IMAP inbox — Fastmail, iCloud, ProtonMail Bridge, Outlook, your own server. Look up your provider’s IMAP host/port and use an app-specific password if they offer one.

Click Test connection. You should see your folders listed.

3. Set up your Notion database

Section titled “3. Set up your Notion database”
  1. Go to https://www.notion.so/my-integrations and click + New integration.
  2. Name it Tickong, give it your workspace, and on the Capabilities tab keep all three content capabilities checked (Read, Update, Insert).
  3. Copy the Internal Integration Secret.
  4. Open (or create) the database that should receive your tickets. Click … (top right) → Connections → search for Tickong → Confirm.
  5. From the database URL, copy the 32-character ID (between the last / and the ?).
    • URL: https://www.notion.so/yourws/7a7fc27697c140308c7446210f709bfb?v=...
    • ID: 7a7fc27697c140308c7446210f709bfb

Your database needs specific properties — see Notion database setup for the exact schema (you can also import the template from there).

Paste the secret + database ID in the wizard, click Test schema. Tickong reads your database and tells you if any property is missing or has the wrong type.

4. (Optional) Connect Vivid SkyBox

Section titled “4. (Optional) Connect Vivid SkyBox”

Skip this step if you only want tickets in Notion. You can come back later from Settings.

If you want auto-listing:

  1. In SkyBox, go to Settings → External Accounts and create an API token.
  2. Apply for an Application Token at https://skybox.vividseats.com/application-sign-up.
  3. Paste your X-Account, X-Api-Token, X-Application-Token, and Vendor ID in the wizard.
  4. Click Test connection — you should see “Authenticated as account X”.

See Vivid SkyBox for pricing strategies and what gets listed automatically.

5. Click Finish

Section titled “5. Click Finish”

You land on the dashboard with the runner already ticking. The poll-interval pill in the top toolbar shows the next tick countdown (default: every 2 minutes).

6. Forward your first email

Section titled “6. Forward your first email”

Forward a real ticket purchase confirmation to the inbox you connected. Within one tick (≤2 min), you’ll see:

  1. A new row appear in the Activity tab.
  2. A new page appear in your Notion database.
  3. The processed email move into the Tickong/Processed label in your inbox (Gmail uses labels, so the message gets archived from the inbox).

If something doesn’t show up, see Troubleshooting.

What’s next

Section titled “What’s next”