Scope catalog
Every category and label your app can request — what each grants, with example matches.
Scopes are slugs from Thread's closed, versioned classification catalog. A category (broad bucket) matches everything under it; a label (precise type) matches only that kind of mail. Granting a category includes all of its labels; an email is always tagged with each label and its parent category, so either tier works in a grant.
Request scopes when registering your app (they seed the default filter users see on the
consent screen), or pass them to openThreadConnect({ scopes: [...] }). The user always
sees — and can narrow — exactly what they're granting.
Two scopes live outside this catalog: calendar.read and calendar.write, covered in
Calendar.
Catalog version 3 · 17 categories · 83 labels. Also available as JSON from GET /catalog (no auth).
Financialfinancial
Receipts, invoices, statements, payments and utility bills from banks, card issuers, payment apps and service providers.
| Label | Grants access to | Example matches |
|---|---|---|
Receipt receipt | Proof of a completed payment — a purchase, charge, or transaction confirmation. | amazon.com — "Your Amazon.com order receipt" squareup.com — "Receipt from Blue Bottle Coffee" |
Invoice invoice | A bill requesting payment, typically with an amount due and a due date. | stripe.com — "Invoice #1234 from Acme Inc." quickbooks.intuit.com — "Invoice due June 30" |
Statement statement | A periodic account summary from a bank, card issuer, or brokerage. | chase.com — "Your statement is ready" fidelity.com — "Your May account statement" |
Payment alert payment_alert | A notification that a payment happened or is about to — charges, due-date reminders, low-balance warnings. | chase.com — "Your card was charged $42.10" paypal.com — "Payment due in 3 days" |
Refund refund | Money returned to the user — refund confirmations and credit notices. | amazon.com — "Your refund has been issued" airbnb.com — "We've refunded your reservation" |
Payout payout | Money paid out to the user from a platform — seller payouts, transfers, disbursements. | stripe.com — "Your payout of $1,250.00 is on its way" etsy.com — "Your deposit has been sent" |
Subscription billing subscription_billing | Recurring-subscription charges, renewals, trial endings, and price changes. | netflix.com — "Your subscription has renewed" spotify.com — "Your Premium payment" |
Tax document tax_document | Tax forms and filings — W-2s, 1099s, filing confirmations, tax-season notices. | intuit.com — "Your 1099 is ready to download" adp.com — "Your W-2 is available" |
Payroll payroll | Salary and wage notifications — payslips, direct-deposit confirmations. | adp.com — "Your pay statement is available" gusto.com — "You've been paid" |
Utility bill utility_bill | Bills from utility and telecom providers — power, water, internet, phone. | pge.com — "Your energy statement is ready" comcast.com — "Your Xfinity bill is available" |
Shoppingshopping
Orders, shipping and delivery from retailers and marketplaces.
| Label | Grants access to | Example matches |
|---|---|---|
Order confirmation order_confirmation | A retailer confirming an order was placed. | amazon.com — "Your order has been placed" target.com — "Thanks for your order!" |
Shipping notification shipping_notification | An order has shipped — carrier handoff and tracking numbers. | amazon.com — "Your package has shipped" ups.com — "Your shipment is on its way" |
Delivery update delivery_update | In-transit and delivered updates — out for delivery, delayed, delivered photos. | fedex.com — "Your package was delivered" usps.com — "Out for delivery today" |
Return return | Product returns and exchanges — return labels, drop-off confirmations, return received. | amazon.com — "Your return label is ready" zappos.com — "We received your return" |
Price drop price_drop | Price-drop and back-in-stock alerts on items the user follows. | camelcamelcamel.com — "Price drop on your watched item" bestbuy.com — "Back in stock" |
Traveltravel
Flight, hotel and transport bookings and disruptions.
| Label | Grants access to | Example matches |
|---|---|---|
Booking confirmation booking_confirmation | A confirmed travel booking — flights, trains, rental cars, activities. | delta.com — "Your trip confirmation" expedia.com — "Booking confirmed: SFO → JFK" |
Itinerary itinerary | Trip itineraries and schedule summaries covering one or more bookings. | tripit.com — "Your itinerary for New York" united.com — "Your upcoming trip details" |
Boarding pass boarding_pass | Boarding passes and e-tickets for a specific departure. | delta.com — "Your boarding pass for flight DL 110" amtrak.com — "Your eTicket" |
Check in check_in | Check-in windows opening and check-in confirmations for flights or stays. | southwest.com — "Check in now for your flight" marriott.com — "Online check-in is available" |
Hotel reservation hotel_reservation | Hotel and lodging reservations — confirmations, modifications, cancellations. | booking.com — "Your reservation is confirmed" airbnb.com — "Reservation confirmed: Lake Tahoe" |
Ride receipt ride_receipt | Receipts for rides and deliveries — rideshare trips, food delivery. | uber.com — "Your Tuesday morning trip with Uber" lyft.com — "Your ride receipt" |
Travel disruption travel_disruption | Delays, cancellations, gate changes, and rebooking notices. | united.com — "Flight UA 512 is delayed" delta.com — "Gate change for your flight" |
Calendarcalendar
Meeting invitations, updates and reminders.
| Label | Grants access to | Example matches |
|---|---|---|
Calendar invite calendar_invite | A new meeting or event invitation. | calendar.google.com — "Invitation: Design review @ Thu 2pm" calendly.com — "New event scheduled" |
Calendar update calendar_update | Changes to an existing event — time moved, location changed, cancelled. | calendar.google.com — "Updated: Design review moved to 3pm" outlook.com — "Meeting cancelled" |
Rsvp rsvp | Attendee responses to an event the user organized — accepted, declined, tentative. | calendar.google.com — "Accepted: Quarterly planning" calendar.google.com — "Declined: 1:1" |
Reminder reminder | Upcoming-event and appointment reminders. | calendly.com — "Reminder: call with Sam in 1 hour" opentable.com — "Reservation reminder: tonight 7pm" |
Meeting notes meeting_notes | Post-meeting artifacts — notes, recordings, transcripts, action items. | zoom.us — "Your meeting recording is ready" otter.ai — "Notes from Product sync" |
Securitysecurity
Verification codes, login and account-security notifications.
| Label | Grants access to | Example matches |
|---|---|---|
Verification code verification_code | One-time passcodes and verification links for sign-in or confirmation. | accounts.google.com — "Your verification code is 482913" github.com — "Your GitHub launch code" |
Login alert login_alert | New or unusual sign-in notifications — new device, new location. | accounts.google.com — "New sign-in on Mac" facebookmail.com — "Did you just log in?" |
Password reset password_reset | Password reset requests and confirmations. | github.com — "Reset your password" apple.com — "Your Apple ID password was reset" |
Security alert security_alert | Account-security warnings — suspicious activity, exposed credentials, policy enforcement. | accounts.google.com — "Critical security alert" haveibeenpwned.com — "You're in a new breach" |
Account notification account_notification | Account lifecycle notices — email changed, plan changed, account created or closed. | apple.com — "Your account information was updated" dropbox.com — "Your plan has changed" |
Workwork
Internal and external work correspondence and document sharing.
| Label | Grants access to | Example matches |
|---|---|---|
Internal message internal_message | Mail from colleagues inside the user's own organization. | (same domain as the user) — "Re: launch timeline" (same domain) — "Notes from standup" |
External correspondence external_correspondence | Business correspondence with people outside the organization — clients, vendors, partners. | (client domain) — "Proposal feedback" (vendor domain) — "Updated contract terms" |
Thread reply thread_reply | A reply in an ongoing conversation thread the user participates in. | (any sender) — "Re: Q3 budget" (any sender) — "RE: RE: meeting follow-up" |
Mention mention | The user is named or @-mentioned in a work tool and notified by email. | docs.google.com — "Ana mentioned you in Roadmap" atlassian.net — "You were mentioned on PROJ-42" |
Document share document_share | A document, file, or folder shared with the user. | drive.google.com — "Ana shared 'Q3 plan' with you" dropbox.com — "A folder was shared with you" |
Approval request approval_request | A request for the user's approval — expenses, time off, purchase orders, access. | expensify.com — "Expense report awaiting your approval" workday.com — "Time-off request needs review" |
Supportsupport
Customer-service requests, replies and ticket updates.
| Label | Grants access to | Example matches |
|---|---|---|
Support request support_request | A support request the user filed — ticket-created confirmations. | zendesk.com — "We received your request (#5821)" support@*.com — "Your case has been created" |
Support reply support_reply | An agent's reply on the user's support ticket. | zendesk.com — "Re: Order never arrived (#5821)" intercom.io — "New reply from support" |
Ticket update ticket_update | Ticket status changes — escalated, pending your reply, resolved, closed. | zendesk.com — "Your ticket has been solved" freshdesk.com — "Ticket status updated" |
Service status service_status | Service incident and maintenance notices — outages, degradations, resolutions. | statuspage.io — "Investigating elevated error rates" heroku.com — "Scheduled maintenance" |
Healthhealth
Appointments, results, prescriptions and provider messages.
| Label | Grants access to | Example matches |
|---|---|---|
Appointment appointment | Medical and wellness appointments — confirmations, reminders, reschedules. | zocdoc.com — "Appointment confirmed with Dr. Lee" mychart.com — "Upcoming visit reminder" |
Lab result lab_result | Lab and test results being ready. | labcorp.com — "Your results are ready" mychart.com — "New test result available" |
Prescription prescription | Prescription lifecycle — ready for pickup, refill due, shipped. | cvs.com — "Your prescription is ready" capsule.com — "Time to refill" |
Insurance insurance | Health-insurance communication — claims, explanations of benefits, coverage changes. | anthem.com — "Your claim has been processed" unitedhealthcare.com — "New EOB available" |
Provider message provider_message | A message from a care provider or clinic portal. | mychart.com — "You have a new message from your care team" onemedical.com — "Message from your provider" |
Legallegal
Contracts, notices and signature requests.
| Label | Grants access to | Example matches |
|---|---|---|
Contract contract | Contracts and agreements sent for review or fully executed. | docusign.net — "Completed: Consulting agreement" (law firm domain) — "Draft MSA for review" |
Nda nda | Non-disclosure agreements sent, signed, or countersigned. | docusign.net — "Please sign: Mutual NDA" hellosign.com — "NDA fully executed" |
Legal notice legal_notice | Formal legal notices — demand letters, court notices, compliance notices. | (court/agency domain) — "Notice of hearing" (law firm domain) — "Formal notice regarding…" |
Signature request signature_request | A document awaiting the user's signature. | docusign.net — "Ana sent you a document to sign" hellosign.com — "Signature requested" |
Policy update policy_update | Terms-of-service and privacy-policy change notices. | paypal.com — "Updates to our legal agreements" google.com — "We're updating our Terms of Service" |
Careercareer
Job applications, candidate threads, interviews and offers.
| Label | Grants access to | Example matches |
|---|---|---|
Job application job_application | Application submitted/received confirmations and status updates on the user's applications. | greenhouse.io — "Thanks for applying to Acme" lever.co — "Update on your application" |
Candidate reply candidate_reply | Replies from candidates in a hiring pipeline the user runs. | (candidate address) — "Re: Senior engineer role" greenhouse.io — "New candidate response" |
Interview interview | Interview scheduling and logistics — invitations, confirmations, prep details. | goodtime.io — "Interview confirmed: Tuesday 10am" greenhouse.io — "Your interview schedule" |
Offer offer | Job offers and offer-letter paperwork. | (company domain) — "Your offer from Acme" docusign.net — "Offer letter ready to sign" |
Recruiter outreach recruiter_outreach | Unsolicited recruiter and sourcing outreach. | linkedin.com — "Exciting opportunity at a fintech startup" (agency domain) — "Quick chat about a role?" |
Personalpersonal
Personal correspondence, family and social notifications from individuals.
| Label | Grants access to | Example matches |
|---|---|---|
Personal message personal_message | Personal one-to-one mail from individuals — friends and acquaintances writing directly. | gmail.com (an individual) — "Dinner next week?" icloud.com (an individual) — "Photos from the trip" |
Family family | Mail from family members and family-related coordination. | (family member) — "Mom's birthday plans" (school domain) — "Parent-teacher conference signup" |
Social notification social_notification | Personal social pings surfaced by email — event invites from friends, group plans. | partiful.com — "You're invited: housewarming" evite.com — "Invitation from Sam" |
Notificationsnotifications
Automated app pings — Slack DMs, Notion mentions, Linear assignments, generic in-app alerts.
| Label | Grants access to | Example matches |
|---|---|---|
App notification app_notification | Generic in-app activity surfaced by email from SaaS tools. | slack.com — "New messages in #general" asana.com — "Task assigned to you" |
Mention alert mention_alert | You-were-mentioned alerts from apps and platforms. | notion.so — "Ana mentioned you in Roadmap" linear.app — "You were mentioned on ENG-204" |
Comment reply comment_reply | Replies to the user's comments or threads in apps. | github.com — "New reply on your discussion" figma.com — "Ana replied to your comment" |
System alert system_alert | Automated system notices from services — quota warnings, job results, expirations. | aws.amazon.com — "Your free-tier usage limit alert" google.com — "Your storage is 90% full" |
Developer toolsdeveloper_tools
Developer infrastructure — code review, CI/CD, deploys, monitoring, incidents and release notes.
| Label | Grants access to | Example matches |
|---|---|---|
Ci status ci_status | Continuous-integration results — build and test passes/failures. | github.com — "Run failed: CI on main" circleci.com — "Workflow build-and-test failed" |
Deploy alert deploy_alert | Deployment events — started, succeeded, failed, rolled back. | vercel.com — "Deployment failed for my-app" netlify.com — "Site deploy succeeded" |
Code review request code_review_request | Pull/merge-request review asks and review activity. | github.com — "Ana requested your review on #482" gitlab.com — "Merge request assigned to you" |
Incident alert incident_alert | On-call and incident pages — triggered, acknowledged, resolved. | pagerduty.com — "Triggered: API latency above SLO" opsgenie.com — "Alert: production incident" |
Monitoring alert monitoring_alert | Monitoring and error-tracking alerts — new errors, threshold breaches. | sentry.io — "New issue: TypeError in checkout" datadoghq.com — "Monitor alert: high CPU" |
Release note release_note | New releases and dependency updates for software the user follows. | github.com — "New release: v2.4.0" npmjs.com — "A new version of your package dependency" |
Educationeducation
Course updates, assignments, certifications and lectures from MOOCs and universities.
| Label | Grants access to | Example matches |
|---|---|---|
Course update course_update | Course announcements and content updates from learning platforms. | coursera.org — "New week unlocked in your course" canvas.instructure.com — "Announcement: syllabus update" |
Assignment due assignment_due | Assignment deadlines and submission reminders. | canvas.instructure.com — "Assignment due Friday" gradescope.com — "Upcoming deadline" |
Certification reminder certification_reminder | Certification and credential lifecycle — expiring soon, renewal windows, exam scheduling. | credly.com — "Your certification expires in 30 days" aws.amazon.com — "Time to recertify" |
Lecture notes lecture_notes | Lecture materials, recordings, and notes shared after class. | canvas.instructure.com — "Lecture 12 slides posted" panopto.com — "New recording available" |
Otherother
Mail that does not fit any more specific category. Catch-all so every email is classifiable.
No precise labels — a catch-all category.
Social
socialSocial networks and community platforms — LinkedIn, X/Twitter, Reddit, Discord, Facebook, forums.
social_connectionsocial_messagesocial_activitysocial_invite