# Twelfth documentation > Generated by docmd ## Documentation Files - [Artefacts & shared documents](https://twelfth.ai/docs/artefacts/) Every file your workspace holds in one place, and how to share a Google Sheet or Doc with Twelfth so the assistant knows about it. - [Twelfth AI and chats](https://twelfth.ai/docs/assistant/) Ask Twelfth about your commercial work, turn a conversation into reviewed action, and find every chat you can access. - [Your daily briefing](https://twelfth.ai/docs/briefing/) The morning read on your commercial book: what changed overnight, what Twelfth surfaced into Triage, and what needs your attention today. - [The Decisions log](https://twelfth.ai/docs/decisions/) A permanent, timestamped record of every decision you have committed, and how each sat against what was recommended. - [Price changes](https://twelfth.ai/docs/decisions/price/) Review and commit the price recommendations Twelfth surfaces in Triage, and see how your committed price compares to what was recommended. - [Purchase orders](https://twelfth.ai/docs/decisions/purchase-orders/) Review and commit buy recommendations: the replenishment orders Twelfth surfaces from lead times, cover and demand before a line runs short. - [Stock transfers](https://twelfth.ai/docs/decisions/transfers/) Review and commit recommendations to move stock between locations before it becomes a shortage or an overstock. - [Watch list](https://twelfth.ai/docs/decisions/watch-list/) The watch list holds items you are monitoring without an action due yet, kept in view so you are ready to act when they move. - [API compatibility](https://twelfth.ai/docs/developers/compatibility/) How Twelfth evolves public APIs without version numbers in URL paths or breaking existing integrations. - [Developer API](https://twelfth.ai/docs/developers/) Connect server-side software to Twelfth's small REST API with a workspace key and stable, unversioned resource paths. - [API reference](https://twelfth.ai/docs/developers/reference/) Twelfth's small read-only REST API, with one focused page per endpoint and a canonical OpenAPI contract for agents. - [List current tasks](https://twelfth.ai/docs/developers/reference/tasks/) Read the current open, unsnoozed tasks across a Twelfth workspace. - [Get workspace](https://twelfth.ai/docs/developers/reference/workspace/) Read the identity and operating defaults of the workspace attached to a Twelfth API key. - [Twelfth for Excel](https://twelfth.ai/docs/extensions/excel/) Twelfth's products, pricing, tasks and projects as Excel tables you can refresh; a chat beside the sheet whose charts land in the workbook as Excel charts. - [Extensions](https://twelfth.ai/docs/extensions/) Twelfth inside the tools your team already uses, such as Excel and Raycast. How extensions connect, what they can read, and how "Allow changes" works. - [Twelfth for Raycast](https://twelfth.ai/docs/extensions/raycast/) Today's actions, product search, projects and a quick way to ask Twelfth, from the Raycast launcher and menu bar on your Mac. - [Get started](https://twelfth.ai/docs/getting-started/) Set up a Twelfth workspace step by step: name it, invite your team, set shared defaults and connect your data, so everyone works from the same rules. - [Home](https://twelfth.ai/docs/home/) How to read Home: the sales sentence and its comparisons, your projects, the routines timeline, your top tasks, and the bar that opens Twelfth AI. - [Welcome to Twelfth](https://twelfth.ai/docs/) Documentation for Twelfth, a shared operating space where commercial teams turn everyday signals into clear decisions and owned action. - [Reading the flow view](https://twelfth.ai/docs/overview/) Flow is a read-only map of the decision pipeline, showing how much work moves from Triage into Pending across every project, by decision type. - [The Pending stage](https://twelfth.ai/docs/pending/) Pending holds the lines you have settled inside a project but not yet recorded, such as an order still to be raised or a price change still to be pushed. - [Remits](https://twelfth.ai/docs/people/) Remits shows who owns each commercial section in your workspace. Spot shared coverage, find gaps, and see the categories assigned to each person. - [Performance](https://twelfth.ai/docs/performance/) Read sales, units and GP against last year, compare categories, check mix and promotion, and see where Performance figures come from. - [How work flows through Twelfth](https://twelfth.ai/docs/pipeline/) The Triage → Pending → raised path every line takes inside a project, and the work that turns a recommendation into a committed, logged decision. - [Read the pricing Brief](https://twelfth.ai/docs/price-intelligence/brief/) Scope the weekly read to a seller portfolio, understand the price index, and move from observations to the SKUs behind them. - [Pricing intelligence](https://twelfth.ai/docs/price-intelligence/) Follow competitor prices across your tracked range, understand what moved, and turn the read into seller-safe reports. - [Create and send pricing reports](https://twelfth.ai/docs/price-intelligence/reports/) Keep internal weekly briefs separate from seller-safe reports, preview the exact outward-facing content, and email it from Twelfth. - [Manage the tracked pricing set](https://twelfth.ai/docs/price-intelligence/tracked-pricing-set/) Import or export the workspace's SKU basket, define tracked views, manage the permitted retailer mix, and understand the plan-controlled collection limits. - [Use the Tracked set](https://twelfth.ai/docs/price-intelligence/tracked-set/) Filter the workspace's tracked SKUs, compare against the last price seen or a rolling average, review coverage and export the underlying data. - [Inspect a tracked SKU](https://twelfth.ai/docs/price-intelligence/tracked-sku/) Expand one SKU inside the tracked table, inspect its price history and rolling competitor index, or use its full page for follow-up actions. - [Products](https://twelfth.ai/docs/products/) Find any line in your range, read its stock, sales and cover, and open its product page for open work, notes, chats, supplier links and price history. - [Projects](https://twelfth.ai/docs/projects/) Everything in flight and the work inside each one: what a project is, how the daily sync fills it, and how a supplier order is raised. - [Promotions](https://twelfth.ai/docs/promotions/) Every promotion line across your supplier deals: how a supplier sheet becomes a deal, how its columns are read, and how each line is decided In or Out. - [Routines](https://twelfth.ai/docs/routines/) What a routine is, the Routines page, a routine's Overview, Tasks, Runs and Setup tabs, Run now, pausing, shadow and live, and muted lines. - [API keys](https://twelfth.ai/docs/settings/ai-and-agents/api-keys/) Create, name, tag and revoke workspace-scoped bearer keys for the Twelfth REST API, servers, scripts and automations. - [ChatGPT](https://twelfth.ai/docs/settings/ai-and-agents/chatgpt/) Connect Twelfth to ChatGPT from the marketplace. Sign in with your Twelfth account to read workspace data, with changes available by opt-in. - [Claude Desktop](https://twelfth.ai/docs/settings/ai-and-agents/claude-desktop/) Use Twelfth in the Claude Desktop app. Add it once from Claude's connector directory and sign in, or connect with a key and an MCP config. - [Claude](https://twelfth.ai/docs/settings/ai-and-agents/claude/) Add Twelfth from Claude's connector directory and sign in. Read workspace data by default, or opt in to selected changes. No API key needed. - [Cursor](https://twelfth.ai/docs/settings/ai-and-agents/cursor/) Connect Cursor to your Twelfth workspace over MCP. Create an API key, paste the config, and confirm your first request. API keys are read-only. - [Gemini](https://twelfth.ai/docs/settings/ai-and-agents/gemini/) Connect Gemini CLI or Gemini to a Twelfth workspace over MCP, read by default: install the Twelfth extension and sign in, or create a key in Settings. - [Glean](https://twelfth.ai/docs/settings/ai-and-agents/glean/) Connect Glean to a Twelfth workspace over a read-only MCP connection: create the key in Settings, register the endpoint, confirm the first request. - [Grok](https://twelfth.ai/docs/settings/ai-and-agents/grok/) Connect Grok to a Twelfth workspace over MCP: add a custom connector at grok.com/connectors and sign in, or use a workspace key and the xAI API. - [AI and agents](https://twelfth.ai/docs/settings/ai-and-agents/) Connect AI assistants and your own servers to Twelfth with MCP. Read by default, allow selected changes, and manage each connection separately. - [Events](https://twelfth.ai/docs/settings/ai-and-agents/mcp-events/) Let an assistant watch a Twelfth workspace and act when something changes, such as new recommendations, competitor price moves or fresh data. - [Generic MCP](https://twelfth.ai/docs/settings/ai-and-agents/mcp/) Connect any MCP-capable assistant to a Twelfth workspace at api.twelfth.ai/mcp with OAuth or a bearer key. Read-only unless you allow changes. - [More assistants](https://twelfth.ai/docs/settings/ai-and-agents/more-assistants/) Add Twelfth as a custom MCP connector in Perplexity, Le Chat, Gemini Enterprise, Kiro, Junie, Amazon Quick, VS Code, Zed, Warp and Goose. - [Vercel Connect](https://twelfth.ai/docs/settings/ai-and-agents/vercel-connect/) Connect a Vercel app or agent to Twelfth's MCP tools for products, sales, inventory, suppliers and pricing, using OAuth or a workspace key. - [VS Code / Copilot](https://twelfth.ai/docs/settings/ai-and-agents/vscode-copilot/) Add Twelfth to VS Code, GitHub Copilot and Copilot CLI for a connection to your workspace that reads by default, in one click or two commands. - [Briefings & alerts](https://twelfth.ai/docs/settings/briefings-and-alerts/) The workspace's starting point for every person's brief and alerts: delivery time, channel, the Monday deep brief, and which alerts are on by default. - [Calendars](https://twelfth.ai/docs/settings/calendars/) Trading, promotion and custom calendars, read from a shared Google Sheet, a monday.com board or a Google Calendar, or updated through chat. - [Categories & remits](https://twelfth.ai/docs/settings/categories/) The managed category registry: curate the categories your team trades and give them names people recognise, while the data keys underneath stay fixed. - [Google Chat](https://twelfth.ai/docs/settings/comms/gchat/) Ask Twelfth in Google Chat, in a direct message or by @mentioning it in a space, once a workspace owner or admin turns Google Chat on in Settings. - [Comms & chat](https://twelfth.ai/docs/settings/comms/) Connect Slack, Google Chat or Microsoft Teams so Twelfth can post into the channels and spaces your team already works in. - [Slack](https://twelfth.ai/docs/settings/comms/slack/) Connect Slack, ask Twelfth in a channel or direct message, save answers to a channel canvas, and understand who can see them. - [Microsoft Teams](https://twelfth.ai/docs/settings/comms/teams/) Add the Twelfth app to your Microsoft 365 tenant so your team can ask Twelfth in Teams: in a chat, a group chat, or by @mentioning it in a channel. - [Decision vocabulary](https://twelfth.ai/docs/settings/decision-vocabulary/) Rename the pipeline stages and decision types so Twelfth speaks your team's language. The wording changes across the workspace; the pipeline does not. - [Guardrails](https://twelfth.ai/docs/settings/guardrails/) The category GP floor, the authority limit and the strategic-vendor lock — the limits every decision passes through, whichever part of Twelfth raised it. - [Adobe Commerce (Magento)](https://twelfth.ai/docs/settings/integrations/adobe-commerce/) A planned read-only e-commerce mirror connector for Adobe Commerce (Magento): orders, products and inventory, in the same shape as the Shopify connector. - [Customer-managed BigQuery](https://twelfth.ai/docs/settings/integrations/bigquery/custom/) Keep your warehouse in your own GCP project and grant Twelfth read-only access to a fixed webapp_* serving contract, with self-serve validation. - [Google BigQuery](https://twelfth.ai/docs/settings/integrations/bigquery/) Connect Google BigQuery to Twelfth three ways: customer-managed read-only access, transaction data inbound, or an inquiry-only outbound sync. - [Outbound sync (BigQuery)](https://twelfth.ai/docs/settings/integrations/bigquery/outbound-sync/) Push Twelfth's recommendations, decisions and tracked pricing to a BigQuery destination so your own BI and downstream systems can consume them. - [Transaction inbound (BigQuery)](https://twelfth.ai/docs/settings/integrations/bigquery/transaction-inbound/) Land raw transaction and customer data in a BigQuery dataset for Twelfth to read, for teams that don't already produce the webapp_* serving contract. - [Blue Yonder](https://twelfth.ai/docs/settings/integrations/blue-yonder/) Blue Yonder on request, read-only or with write-back, so Twelfth's recommendations line up with how your ranges and space are planned. - [Custom integrations](https://twelfth.ai/docs/settings/integrations/custom/) Read a system that isn't in the catalogue, such as a warehouse, internal API, S3 or GCS bucket, SFTP or read replica, through a read-only pipeline. - [Databricks](https://twelfth.ai/docs/settings/integrations/databricks/) A planned data-warehouse connector for Databricks: read-only lakehouse queries against your own Unity Catalog, scoped to the data you grant Twelfth. - [Destination delivery and troubleshooting](https://twelfth.ai/docs/settings/integrations/destinations/delivery/) Choose decision filters and delivery triggers, understand Recorded, Staged and Executed, and recover failed spreadsheet, API or webhook deliveries. - [Destinations](https://twelfth.ai/docs/settings/integrations/destinations/) Send committed decisions to spreadsheets, custom APIs or webhooks, choose what each destination receives, and follow delivery on the decision ledger. - [Spreadsheet destinations](https://twelfth.ai/docs/settings/integrations/destinations/spreadsheets/) Deliver decisions to Google Sheets or Excel workbooks in Drive, choose safe tab layouts, map columns, and prepare Retail Express upload templates. - [System API destinations](https://twelfth.ai/docs/settings/integrations/destinations/system-api/) Connect a customer-provided API to receive committed decisions, test it safely, map request fields, and identify the reference returned by the system. - [Webhook destinations](https://twelfth.ai/docs/settings/integrations/destinations/webhooks/) Send decision batches to your receiving system, verify webhook signatures, handle repeated requests, and return references for the decision ledger. - [Email](https://twelfth.ai/docs/settings/integrations/email/) A planned Workplace connector for email in Twelfth: briefing delivery to the people who need it, and supplier email threads alongside the related work. - [Google Sheets and Drive](https://twelfth.ai/docs/settings/integrations/google-files/) Share Google files with Twelfth for calendars, targets and AI context, or give Editor access for requested templates and decision destinations. - [Read Google files into Twelfth](https://twelfth.ai/docs/settings/integrations/google-files/reading/) Use shared Google Sheets as calendar or target sources, link documents as AI context, and understand when each feature refreshes its data. - [Google file sharing and access](https://twelfth.ai/docs/settings/integrations/google-files/sharing/) Share a Google file with Twelfth, choose Viewer or Editor, confirm the workspace it belongs to, and resolve missing files or revoked access. - [Google templates and spreadsheet destinations](https://twelfth.ai/docs/settings/integrations/google-files/writing/) Create a starter calendar or target tab on request, or give a spreadsheet destination Editor access to receive committed decisions from Twelfth. - [Google Merchant Center](https://twelfth.ai/docs/settings/integrations/google-merchant-center/) Request Google Merchant Center, understand the current account and domain connection, and review its Google permissions before connecting. - [Google Search Console](https://twelfth.ai/docs/settings/integrations/google-search-console/) Connect Google Search Console to Twelfth to read search performance, queries, and verified sites over a read-only Google grant. - [Integrations](https://twelfth.ai/docs/settings/integrations/) Connect systems to Twelfth, find Excel and Raycast extensions, and configure approved Retail Express writeback or decision destinations. - [Maropost Commerce Cloud (Neto)](https://twelfth.ai/docs/settings/integrations/maropost/) Connect a Maropost Commerce Cloud (Neto) store to a Twelfth workspace with a read-only staff user's API key. Orders sync every 15 minutes. - [Microsoft 365 calendars and Excel plans](https://twelfth.ai/docs/settings/integrations/microsoft-365/calendars-and-excel/) Use Outlook events or Excel worksheets for planning calendars, create a starter worksheet, and connect Excel to reviewed sales and performance targets. - [Microsoft 365 files as AI context](https://twelfth.ai/docs/settings/integrations/microsoft-365/files/) Link OneDrive and SharePoint files so Twelfth can read their text, choose the right workspace or remit scope, and keep the content current. - [Microsoft 365](https://twelfth.ai/docs/settings/integrations/microsoft-365/) Use Outlook calendars and Excel plans in Twelfth, link OneDrive and SharePoint files as AI context, and choose the permissions your workspace needs. - [Microsoft 365 permissions and settings](https://twelfth.ai/docs/settings/integrations/microsoft-365/settings/) Connect the right Microsoft account, grant read or optional Excel write permissions, understand personal OneDrive access, and resolve connection problems. - [monday.com](https://twelfth.ai/docs/settings/integrations/monday/) Connect a monday.com account, read boards as planning calendars, and hand a board to the assistant as written context. - [POS data feed](https://twelfth.ai/docs/settings/integrations/pos-data-feed/) A planned read-only connector for network sales and volume from a point-of-sale data feed, for chains whose sales don't flow through one commerce platform. - [Qoblex data mapping and troubleshooting](https://twelfth.ai/docs/settings/integrations/qoblex/data-mapping/) Understand Qoblex categories, suppliers, costs, tax basis, stock and order quantities, and resolve missing or doubled sales in Twelfth. - [Qoblex inbound sync](https://twelfth.ai/docs/settings/integrations/qoblex/inbound-sync/) Follow the first Qoblex catch-up, catalogue and order refresh schedules, live progress, manual sync and errors without interrupting the background read. - [Qoblex](https://twelfth.ai/docs/settings/integrations/qoblex/) Connect Qoblex read-only, follow catalogue and order sync, and understand how products, stock, purchase orders, costs and tax basis appear in Twelfth. - [Qoblex setup and settings](https://twelfth.ai/docs/settings/integrations/qoblex/setup/) Create a Qoblex API key, connect it to one Twelfth workspace, replace a refused key, and disconnect without deleting imported business data. - [Request an integration](https://twelfth.ai/docs/settings/integrations/request/) Ask Twelfth for a new connector, a deeper version of an existing one, missing data, or a bespoke integration, using a form scoped to what you need. - [Retail Express inbound sync](https://twelfth.ai/docs/settings/integrations/rex/inbound-sync/) Check Retail Express nightly update health, source table coverage, freshness, and the data the managed import publishes to Twelfth. - [Retail Express](https://twelfth.ai/docs/settings/integrations/rex/) Connect Retail Express to Twelfth with a managed nightly import, approved price writeback, and mapped end-of-life updates. - [Retail Express settings](https://twelfth.ai/docs/settings/integrations/rex/settings/) Set up Rex writeback credentials, select prices and lifecycle mappings, and configure source record links and data rules for your workspace. - [Retail Express writeback](https://twelfth.ai/docs/settings/integrations/rex/writeback/) Send approved prices and optional EOL product updates to Rex, review their outcomes, and prepare purchase-order and transfer upload workbooks. - [Shopify inbound data](https://twelfth.ai/docs/settings/integrations/shopify/inbound-sync/) Understand Shopify order events, allocated discounts, cancellations, catalogue requirements, and the current limits of historical and refund data. - [Shopify](https://twelfth.ai/docs/settings/integrations/shopify/) Connect one Shopify store to a Twelfth workspace, read order events, understand discounts and current sync coverage, and manage the connection. - [Snowflake](https://twelfth.ai/docs/settings/integrations/snowflake/) A planned data-warehouse connector for Snowflake: read-only warehouse queries against your own Snowflake database, scoped to the data you grant Twelfth. - [Members](https://twelfth.ai/docs/settings/members/) Invite people to a Twelfth workspace, manage each member's access, and let anyone with a verified email on your company domain join automatically. - [My workspaces](https://twelfth.ai/docs/settings/my-workspaces/) Every Twelfth workspace you belong to in one place. Switch between them, create a new one, accept an invitation, or leave a workspace you no longer need. - [Notifications](https://twelfth.ai/docs/settings/notifications/) Choose your personal briefing delivery schedule and alert preferences, starting from the workspace default and overriding any control for yourself. - [Operational alerts](https://twelfth.ai/docs/settings/operational-alerts/) Who is emailed when a chat surface or an integration stops working for your workspace, what is being watched, and what has broken lately. - [Settings overview](https://twelfth.ai/docs/settings/overview/) Where every setting lives in Twelfth: the same five groups the Settings page uses, and who can change each one. - [Preferences](https://twelfth.ai/docs/settings/preferences/) Choose your default home view, first day of the week, date conventions and interface behaviour. These personal settings change nothing for anyone else. - [Price bands](https://twelfth.ai/docs/settings/price-bands/) The bands that decide when a line reads as priced above or below market, who set them, and who can remove them. - [Pricing](https://twelfth.ai/docs/settings/pricing/) See the retailers Twelfth tracks for your workspace, request more, and set pricing defaults. - [Profile](https://twelfth.ai/docs/settings/profile/) Update the display name, title and other personal details colleagues see for you across your Twelfth workspaces, from the Profile card on the Account page. - [Projects](https://twelfth.ai/docs/settings/projects/) How a workspace runs its projects: the rules every project follows, and the rules each workflow keeps for itself. - [Regional & commercial](https://twelfth.ai/docs/settings/regional-and-commercial/) Where the business trades, in what currency, and how tax is read: the facts every commercial value in Twelfth is shown against. - [Security and access](https://twelfth.ai/docs/settings/security-and-access/) Protect your Twelfth account with sign-in methods, two-factor authentication, recovery codes, passkeys, and session controls. - [Google Workspace](https://twelfth.ai/docs/settings/single-sign-on/google-workspace/) Set up SAML single sign-on to Twelfth from Google Workspace with a custom SAML app: what to create in the Admin console and what to enter in Twelfth. - [Single sign-on & SCIM](https://twelfth.ai/docs/settings/single-sign-on/) Sign in to Twelfth through your own identity provider (SAML 2.0 or OpenID Connect) and let your directory manage who has access. - [Microsoft Entra ID](https://twelfth.ai/docs/settings/single-sign-on/microsoft-entra/) Set up SAML single sign-on to Twelfth from Microsoft Entra ID (formerly Azure AD), then optional SCIM provisioning so Entra manages who has access. - [Okta](https://twelfth.ai/docs/settings/single-sign-on/okta/) Set up SAML single sign-on to Twelfth from Okta, then optional SCIM provisioning so Okta manages who has access — the app integration and the Twelfth side. - [Other providers & OpenID Connect](https://twelfth.ai/docs/settings/single-sign-on/other-providers/) Connect any SAML 2.0 or OpenID Connect identity provider to Twelfth, such as JumpCloud, OneLogin, Ping, Keycloak or Auth0, with the settings it needs. - [Suppliers](https://twelfth.ai/docs/settings/suppliers/) Lead times, order terms and the supplier portfolio: what Twelfth knows about the people you buy from, and how each supplier is performing. - [Tasks & routines](https://twelfth.ai/docs/settings/tasks-and-routines/) Where to manage the rules that raise tasks and the settings around their delivery. - [Workspace security](https://twelfth.ai/docs/settings/workspace-security/) Require two-factor authentication with an authenticator app for every member of your Twelfth workspace, from the Security & SSO tab of the Workspace page. - [Workspace](https://twelfth.ai/docs/settings/workspace/) Manage your organisation in Twelfth: its name and logo, how people sign in, the two-factor and SSO policy, chat sharing, invitations, and deletion. - [Signing in](https://twelfth.ai/docs/signing-in/) Sign in to Twelfth with your Microsoft work account, your Google account, a passkey, email and password, or your organisation's single sign-on. - [Supplier activity](https://twelfth.ai/docs/suppliers/activity/) How to read a supplier's Activity tab: its open tasks, the decision pipeline by period, the Table, Flow and Over time views, and decisions on its lines. - [Supplier facts](https://twelfth.ai/docs/suppliers/facts/) A supplier's Facts tab: contacts, payment terms, lead time, minimum order, currency, how to order, and the reliability Twelfth measures. - [Suppliers](https://twelfth.ai/docs/suppliers/) The supplier portfolio and a supplier's page: what each tab is for, where to find a supplier's tasks, notes, terms, range and ordering details. - [Ordering and supplier portals](https://twelfth.ai/docs/suppliers/ordering/) Set how your team orders from a supplier, and how a supplier portal connection works: what it reads, what it can never do, and what you see. - [Supplier range and invoices](https://twelfth.ai/docs/suppliers/range/) A supplier's Range tab lists every product they provide in your remits; the Invoices tab shows deliveries invoiced above the order price. - [Supplier timeline](https://twelfth.ai/docs/suppliers/timeline/) A supplier's Timeline tab: notes your team adds, chats linked to the supplier, and past decisions with their reasons, newest first. - [Sales and performance targets](https://twelfth.ai/docs/targets/) Manage company, category, remit and buyer targets with workbook uploads, linked Google Sheets or Excel tabs, and monthly starter templates. - [Tasks](https://twelfth.ai/docs/tasks/) The Tasks list and the task page: where tasks come from, sorting and filtering the table, working a task's lines, and how a task closes. - [Working in Triage](https://twelfth.ai/docs/triage/) Triage is the first stage of every engine-fed project. Review the lines Twelfth has surfaced, adjust them against what you know, and settle each one.