Connections OAuth Scopes

generated: '2026-11-04'
method: searched
source: https://studio.connectionsapi.com/v1/scopes
docs: https://studio.connectionsapi.com/v1/agent-guide
oidc_discovery: https://accounts.connectionsapi.com/.well-known/openid-configuration
note: The scope catalog is served by the provider at GET /v1/scopes (Studio). The same scopes gate API keys and
  OAuth tokens. oidc_scopes_supported is copied from the OIDC discovery document.
scopes:
- name: contacts:read
  description: Pull contact profiles.
  plane: Connections
- name: contacts:write
  description: Create and update contacts.
  plane: Connections
- name: touches:read
  description: Pull relationship touch history.
  plane: Connections
- name: touches:write
  description: Record relationship touch notes.
  plane: Connections
- name: search:read
  description: Run scoped relationship search.
  plane: Connections
- name: graph:read
  description: Read your own first/second-degree network and warm-path introductions.
  plane: Connections
- name: introductions:read
  description: Read introduction requests (warm-path intros).
  plane: Connections
- name: introductions:write
  description: Create and update introduction requests.
  plane: Connections
- name: events:read
  description: Events, products, and registrations.
  plane: Connections
- name: events:write
  description: Events, products, questions, routing.
  plane: Connections
- name: hosts:read
  description: Pull event host records.
  plane: Connections
- name: hosts:write
  description: Create and update event host records.
  plane: Connections
- name: calendars:read
  description: Calendars, entries, and registration.
  plane: Connections
- name: calendars:write
  description: Create calendars and add entries.
  plane: Connections
- name: members:read
  description: Resolve a scanned membership card to member number and status.
  plane: Connections
- name: checkins:read
  description: List a community's membership check-in log.
  plane: Connections
- name: checkins:write
  description: Log membership attendance at the door.
  plane: Connections
- name: forms:read
  description: List forms, their configuration and the answers submitted to them.
  plane: Connections
- name: forms:write
  description: Create and update forms.
  plane: Connections
- name: registrations:read
  description: List event registrations across your workspace.
  plane: Connections
- name: registrations:write
  description: Create and update event registrations.
  plane: Connections
- name: bundles:read
  description: List event/product bundles.
  plane: Connections
- name: bundles:write
  description: Create and update bundles.
  plane: Connections
- name: myconnect:read
  description: Read your My Connect profile.
  plane: Connections
- name: myconnect:write
  description: Update your My Connect profile.
  plane: Connections
- name: email_signatures:read
  description: List your email signatures.
  plane: Connections
- name: email_signatures:write
  description: Create and update email signatures.
  plane: Connections
- name: webhooks:read
  description: List webhook subscriptions.
  plane: Webhooks
- name: webhooks:write
  description: Create and delete webhook subscriptions.
  plane: Webhooks
- name: pay:read
  description: Subscriptions, receipts, revenue, product catalog, licence entitlement. LIVE.
  plane: Pay
- name: pay:write
  description: Products and prices on linked Stripe accounts, plus issuing software licences, redemption codes,
    and seats.
  plane: Pay
- name: pay:products
  description: Create, update and import catalog products. Nothing else in Pay.
  plane: Pay
- name: analytics:read
  description: Overview, pages, errors, funnels, anomalies. LIVE.
  plane: Analytics
- name: analytics:write
  description: Create tracked sites (segmented into a company) + their ingest keys.
  plane: Analytics
- name: ads:read
  description: List your ad campaigns + their company, and read your landing pages.
  plane: Ads
- name: ads:write
  description: Create / edit / submit / pause ad campaigns (each inside a company), and publish / replace / delete
    landing pages.
  plane: Ads
- name: apps:read
  description: List your OAuth-app registrations. LIVE.
  plane: Studio
- name: apps:write
  description: Create, retry, and withdraw OAuth-app (Sign in with Connections) registrations. LIVE.
  plane: Studio
- name: keys:read
  description: List your API keys. LIVE.
  plane: Studio
- name: keys:write
  description: Mint, restrict, reveal, and revoke API keys (your own tenant). LIVE.
  plane: Studio
- name: projects:read
  description: List your projects. LIVE.
  plane: Studio
- name: projects:write
  description: Create, rename, and archive projects. LIVE.
  plane: Studio
- name: companies:read
  description: List the companies you own. LIVE.
  plane: Companies
- name: companies:write
  description: Create and rename companies - the org an analytics site / ad campaign / Stripe account attaches to.
    LIVE.
  plane: Companies
- name: deals:read
  description: Browse + read marketplace deals (list, get). LIVE.
  plane: Deals
- name: deals:write
  description: Create, update, close, renew, save, and express interest on deals - plus the AI Creator (parse/createDraft,
    billable). A read-only key cannot call the Creator. LIVE.
  plane: Deals
- name: chat:read
  description: List your bots, read conversations, and list knowledge documents. LIVE.
  plane: Chat
- name: chat:write
  description: Mint bots and upload knowledge documents (the citation source the support bot answers from). LIVE.
  plane: Chat
- name: notes:read
  description: List and read notes.
  plane: Notes
- name: notes:write
  description: Create, update, and delete notes.
  plane: Notes
- name: goals:read
  description: List and read goals and their progress.
  plane: Notes
- name: goals:write
  description: Create, update, complete, and delete goals.
  plane: Notes
- name: message:read
  description: Read the message inbox and one conversation thread.
  plane: Message
- name: message:write
  description: Reply in a conversation the member belongs to.
  plane: Message
- name: email:read
  description: Read your send log, delivery events, metrics and inbox conversations.
  plane: Send
- name: email:organize
  description: Label, archive, trash, snooze and mark conversations read or unread, and write drafts for a person
    to approve, with no sending and no inbox or domain management. Includes read.
  plane: Send
- name: email:sandbox
  description: 'Test mode: every send the key makes is checked like a real one and delivered nowhere, with simulated
    delivery, bounce and complaint events. Reaches send, batch send and the reads only. Add email:send or email:read
    beside it.'
  plane: Send
  narrows: true
- name: email:send
  description: Send, reply to and forward email, label conversations, schedule sends and add suppressions.
  plane: Send
- name: email:manage
  description: Connect and verify domains, turn on receiving, set up inboxes and forwarding, edit templates and
    manage the suppression list. Includes read, organize and send.
  plane: Send
- name: schedule:read
  description: List calendar blocks and run conflict checks. LIVE.
  plane: Schedule
- name: schedule:write
  description: Create, update, and delete native calendar events. LIVE.
  plane: Schedule
- name: usage:read
  description: 'Read AI-subscription quota: weekly %, burn rate, and whether you run out before the reset.'
  plane: Usage
- name: storage:describe-image
  description: Describe an image - alt text + searchable description from a hosted vision model. LIVE.
  plane: Storage
- name: storage:transcribe
  description: Transcribe audio to text with speaker labels (self-hosted Parakeet, with faster-whisper for other
    languages). LIVE.
  plane: Storage
- name: storage:read
  description: Search your own files, recordings and transcripts.
  plane: Storage
- name: storage:write
  description: Move your own files to your Trash and restore them from it.
  plane: Storage
- name: ai:image
  description: Generate a picture from a text prompt at low, medium or high quality, square, landscape or portrait,
    or enlarge a small photo 4x (quoted first, charged only when confirmed). Charged in credits per picture.
  plane: AI
- name: boardroom:read
  description: See the workspace's boardrooms, the board members and scenes in them, and past meetings with their
    minutes.
  plane: Boardroom
- name: boardroom:write
  description: Hold meetings in the workspace's boardrooms, and add, edit or remove its rooms, board members, scenes
    and company brief.
  plane: Boardroom
- name: book:read
  description: Open the workspace's books and read their chapters, story bibles, revision history and past reviews.
  plane: Book
- name: book:write
  description: Plan, write, edit and reorder the workspace's books and chapters, keep their story bibles, and run
    reviews on them.
  plane: Book
- name: sign:read
  description: See your documents and envelopes, their status, and download the signed copies and certificates.
  plane: Sign
- name: sign:write
  description: Create documents, prepare and send envelopes, remind signers, void envelopes, and use templates.
  plane: Sign
- name: realtor:read
  description: Run a site report or one land tool for an address, and list or reopen your saved sites.
  plane: Realtor
- name: realtor:write
  description: Save or delete a saved site, and, only with an explicit confirm, buy an owner lookup, phone numbers,
    a mailed letter or postcard with your Connections credits.
  plane: Realtor
- name: market:read
  description: List your Market listings and read the buyer leads on your property listings.
  plane: Market
- name: market:write
  description: Create, change, publish and unpublish your property listings.
  plane: Market
- name: games:read
  description: List your Games developer games and read their uploaded versions.
  plane: Games
- name: games:write
  description: Create games, upload versions and launch them to beta or live.
  plane: Games
- name: rivals:read
  description: Read the workspace's watched competitors and the ads Rivals has stored for them, from Rivals' own
    store.
  plane: Rivals
- name: sales:read
  description: Read the workspace's leads, deals, today list and outreach drafts.
  plane: Leads
- name: sales:write
  description: 'Work the workspace''s leads: draft and decide outreach, move and update deals, and run the lead
    checkup.'
  plane: Leads
- name: dictation:listen
  description: Open a dictation session that transcribes audio; each second of audio spends the account's credits.
  plane: Dictation
- name: life:read
  description: Count and list your own visits and the places you have been.
  plane: Life
- name: life:write
  description: Let your phone record when you arrive and leave, and name your own places.
  plane: Life
- name: profile:read
  description: Read your own profile and your saved postal addresses.
  plane: Accounts
- name: profile:write
  description: Set your own time zone.
  plane: Accounts
- name: history:read
  description: List, search, read and compare your own earlier versions.
  plane: History
- name: history:restore
  description: Get an earlier version's kept copy back so its owning plane can restore it.
  plane: History
- name: calls:read
  description: List your own recorded calls and read one with its transcript.
  plane: Calls
- name: calls:write
  description: File a recorded call, rename it, link it to a contact and ask for its transcript.
  plane: Calls
- name: wallpaper:read
  description: List wallpapers, read one, and download originals.
  plane: Wallpaper
- name: newsletter:read
  description: Open the workspace's publications, read and export their subscriber lists, and read their posts and
    settings.
  plane: Newsletter
- name: newsletter:write
  description: Change the workspace's publications, add, import and update subscribers, and draft, edit and publish
    posts (sending an issue still needs the workspace owner's approval).
  plane: Newsletter
- name: legal:read
  description: Open the workspace's legal documents, their versions and drafts, read and export who accepted them,
    and read its cookie banners and consent records.
  plane: Legal
- name: legal:write
  description: Create documents, edit drafts and queue changes, publish a version quietly, set the documents' address
    and reply-to, record acceptances, and set up cookie banners, their cookie lists and scans (emailing people about
    a version stays with a signed-in member).
  plane: Legal
- name: referrals:read
  description: Read referral programs, codes, conversions, webhooks, and your own advocate earnings.
  plane: Referrals
- name: referrals:write
  description: Run a referral program end to end - create/activate/pause/end programs, mint and disable codes, qualify
    or reject conversions, release payouts, and manage webhooks.
  plane: Referrals
- name: services:read
  description: List the services connected to your company (the MCP server's operators). LIVE.
  plane: Studio
- name: services:write
  description: Connect / provision / disconnect a service the agent operates via the MCP server (AWS connect mints
    a dedicated scoped key). LIVE.
  plane: Studio
oidc_scopes_supported:
- openid
- profile
- email
- email:real
- photo
- company:select
- companies:read
- companies:write
- company_facts:read
- company_facts:write
- contacts:read
- contacts:write
- contacts:delete
- touches:read
- touches:write
- search:read
- introductions:read
- introductions:write
- graph:read
- events:read
- events:write
- events:delete
- hosts:read
- hosts:write
- hosts:delete
- registrations:read
- registrations:write
- forms:read
- forms:write
- forms:delete
- bundles:read
- bundles:write
- bundles:delete
- calendars:read
- calendars:write
- calendars:delete
- myconnect:read
- myconnect:write
- email_signatures:read
- email_signatures:write
- email:read
- email:send
- email:manage
- email:sandbox
- dictation:listen
- webhooks:read
- webhooks:write