{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LedgerSync","description":"Connect your users' bank accounts and pull their transactions, statements, and balances through one uniform API.","colors":{"primary":"#0891B2","light":"#22D3EE","dark":"#0E7490"},"logo":{"light":"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/logo/ledgersync-wordmark.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=b149d57dc2f40804f937b11e31060496","dark":"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/logo/ledgersync-wordmark.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=b149d57dc2f40804f937b11e31060496"},"favicon":"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/favicon.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=223187cbc5ee95ae162ffd35e5935db1","navbar":{"links":[{"href":"mailto:support@ledgersync.com","label":"Support"}],"primary":{"type":"button","label":"Request access","href":"https://portal.ledgersyncappv2.com"}},"footer":{"socials":{"website":"https://ledgersync.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ledgersync","hasAudioNarration":false,"actualSubdomain":"ledgersync","customDomains":["docs.ledgersyncappv2.com"],"gitSource":{"type":"github","owner":"ledgersync-app","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6add29d60504bfbbf7e80db6"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b00d931407c66bc0b804a16","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":59},{"language":"default","tag":"v2 API (legacy)","count":50},{"language":"default","tag":"LedgerSync MCP","count":39},{"language":"default","tag":"Documentation","count":14},{"language":"default","tag":"Connections","count":9},{"language":"default","tag":"account-api","count":9},{"language":"default","tag":"Clients","count":8},{"language":"default","tag":"client-api","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Webhooks","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"ai-connector.css","content":".lsai-page{--lsai-green: #1b7a52;--lsai-green-dark: #155f40;--lsai-fill: #1b7a52;--lsai-fill-hover: #155f40;--lsai-green-soft: #e8f5ee;--lsai-green-line: #c9e3d5;--lsai-ink: #1f2937;--lsai-muted: #6b7280;--lsai-line: #e3e8ec;--lsai-card: #ffffff;--lsai-gray-soft: #f3f5f7;--lsai-yellow-soft: #fdf6dd;--lsai-yellow-line: #efd78f;--lsai-red-soft: #fdecec;--lsai-red-line: #f3b9b9;--lsai-bg: rgb(var(--background-light, 255 255 255));max-width:880px;margin:0 auto;padding:32px 24px 48px;color:var(--lsai-ink);font-size:16px;line-height:1.6}.dark .lsai-page{--lsai-green: #3fb27f;--lsai-green-dark: #57c592;--lsai-green-soft: #12291f;--lsai-green-line: #24513a;--lsai-ink: #e5e7eb;--lsai-muted: #9ca3af;--lsai-line: #2b3138;--lsai-card: #14181c;--lsai-gray-soft: #1a1f24;--lsai-yellow-soft: #2a2412;--lsai-yellow-line: #5c4c1c;--lsai-red-soft: #2c1717;--lsai-red-line: #6a2c2c;--lsai-bg: rgb(var(--background-dark, 10 13 16))}.lsai-title{font-size:2rem;line-height:1.2;font-weight:700;margin:0 0 8px;color:var(--lsai-ink)}.lsai-subtitle{font-size:1.05rem;color:var(--lsai-muted);margin:0 0 20px}.lsai-page h2{font-size:1.3rem;font-weight:700;margin:28px 0 12px;color:var(--lsai-ink)}.lsai-page h3{font-size:1.1rem;font-weight:700;margin:20px 0 8px;color:var(--lsai-ink)}.lsai-page p,.lsai-page span[data-as=\"p\"]{display:block;margin:0 0 10px}.lsai-step-text>span[data-as=\"p\"]:last-child,.lsai-note>span[data-as=\"p\"]:last-child,.lsai-choice-text>span[data-as=\"p\"]:last-child,.lsai-box-text>span[data-as=\"p\"]:last-child,.lsai-test-more>span[data-as=\"p\"]:last-child{margin-bottom:0}.lsai-page a:not(.lsai-btn):not(.lsai-thumb){color:var(--lsai-green);font-weight:600;text-decoration:none}.lsai-page a:not(.lsai-btn):not(.lsai-thumb):hover{text-decoration:underline}.lsai-page ul,.lsai-page ol:not(.lsai-progress){margin:4px 0 10px;padding-left:22px}.lsai-page li{margin:2px 0}.lsai-page ul li{list-style:disc}.lsai-page .prose li{list-style:none}.lsai-page ol:not(.lsai-progress) li{list-style:decimal}.lsai-page code:not(.lsai-copy-text){font-size:0.9em;background:var(--lsai-gray-soft);border-radius:4px;padding:1px 5px}.lsai-page table{width:100%;border-collapse:collapse;margin:8px 0 16px;font-size:0.95rem}.lsai-page th{text-align:left;background:var(--lsai-gray-soft);font-weight:700;padding:8px 10px;border-bottom:1px solid var(--lsai-line)}.lsai-page td{padding:8px 10px;border-bottom:1px solid var(--lsai-line);vertical-align:top}.lsai-head{display:flex;flex-wrap:wrap;align-items:flex-start;justify-content:space-between;gap:12px 20px}.lsai-head-text{flex:1 1 420px;min-width:0}.lsai-video-button{display:flex;flex:0 0 auto;align-items:center;gap:10px;width:max-content;max-width:100%;cursor:pointer;border:1px solid var(--lsai-line);border-radius:12px;padding:10px 16px 10px 10px;background:var(--lsai-card);box-shadow:0 1px 2px rgba(0, 0, 0, 0.06);font:inherit;color:var(--lsai-ink);text-align:left}.lsai-video-button:hover{border-color:var(--lsai-green)}.lsai-video-button:focus-visible{outline:3px solid var(--lsai-green);outline-offset:2px}.lsai-video-play{display:inline-flex;align-items:center;justify-content:center;width:36px;height:36px;border-radius:50%;background:var(--lsai-fill);color:#ffffff;font-size:0.85rem;padding-left:2px}.lsai-video-label{display:flex;flex-direction:column;line-height:1.25;font-size:0.85rem;color:var(--lsai-muted)}.lsai-video-label strong{color:var(--lsai-ink);font-size:0.95rem}.lsai-lightbox.lsai-video-box{cursor:default}.lsai-video-box .lsai-lightbox-note{pointer-events:none}.lsai-video-player{display:block;width:min(1100px, 100%);max-height:calc(100vh - 120px);border-radius:8px;background:#000000;box-shadow:0 12px 40px rgba(0, 0, 0, 0.45)}.lsai-progress{display:grid;grid-template-columns:repeat(5, 1fr);gap:6px;list-style:none;margin:0 0 24px;padding:0}.lsai-progress-item{list-style:none;margin:0}.lsai-progress-bar{display:block;height:4px;border-radius:2px;background:var(--lsai-line);margin-bottom:6px}.lsai-progress-label{display:flex;align-items:center;gap:6px;font-size:0.8rem;color:var(--lsai-muted);line-height:1.3}.lsai-done .lsai-progress-bar{background:var(--lsai-green-line)}.lsai-done .lsai-progress-label{color:var(--lsai-green)}.lsai-current .lsai-progress-bar{background:var(--lsai-green)}.lsai-current .lsai-progress-label{color:var(--lsai-ink);font-weight:700}.lsai-progress-now{display:none;font-size:0.85rem;font-weight:700;color:var(--lsai-ink);margin:-14px 0 20px}.lsai-step{display:flex;gap:16px;align-items:flex-start;padding:18px 0;border-bottom:1px solid var(--lsai-line)}.lsai-step-num{flex:none;width:32px;height:32px;border-radius:50%;background:var(--lsai-fill);color:#ffffff;font-weight:700;display:flex;align-items:center;justify-content:center;margin-top:2px}.lsai-step-main{flex:1;min-width:0}.lsai-step-label{font-size:0.72rem;letter-spacing:0.08em;text-transform:uppercase;color:var(--lsai-muted);font-weight:600}.lsai-step-title{font-size:1.1rem;font-weight:700;margin:2px 0 6px}.lsai-step-text p:last-child{margin-bottom:0}.lsai-thumbs{flex:none;width:190px;display:flex;flex-direction:column;gap:10px}.lsai-thumb{width:100%;text-decoration:none;display:block;cursor:zoom-in}.lsai-lightbox{position:fixed;inset:0;z-index:1000;background:rgba(15, 23, 42, 0.86);display:flex;flex-direction:column;align-items:center;justify-content:center;gap:12px;padding:24px;cursor:zoom-out}.lsai-lightbox img{max-width:min(1280px, 100%);max-height:calc(100vh - 90px);border-radius:8px;box-shadow:0 12px 40px rgba(0, 0, 0, 0.45);background:#ffffff}.lsai-lightbox-note{color:#ffffff;font-size:0.95rem}.lsai-lightbox-close{position:absolute;top:16px;right:16px;background:#ffffff;color:#111827;border:0;border-radius:6px;padding:8px 16px;font-weight:700;font-size:0.95rem;cursor:pointer}.lsai-page td code{white-space:nowrap}.lsai-page div[class*=\"--page-padding:20px\"]{margin-top:4px!important;margin-bottom:8px!important;padding-top:0!important;padding-bottom:0!important}.lsai-route #topbar-cta-button,.lsai-route a[href=\"https://portal.ledgersyncappv2.com\"].whitespace-nowrap,.lsai-route li:has(>a[href=\"https://portal.ledgersyncappv2.com\"].whitespace-nowrap),.lsai-route li.whitespace-nowrap>a[href=\"https://portal.ledgersyncappv2.com\"]{display:none!important}.lsai-thumb img{display:block;width:100%;height:auto;border:1px solid var(--lsai-line);border-radius:6px;margin:0;box-shadow:0 1px 2px rgba(0, 0, 0, 0.06)}.lsai-thumb:hover img{border-color:var(--lsai-green)}.lsai-page a.lsai-thumb,.lsai-page a.lsai-thumb:hover{text-decoration:none!important;border-bottom:0!important}.lsai-page a.lsai-thumb .lsai-thumb-caption{color:var(--lsai-muted)!important;font-weight:400!important;text-decoration:none!important}.lsai-thumb-caption{display:block;font-size:0.75rem;color:var(--lsai-muted);text-align:center;margin-top:4px}.lsai-btn{display:inline-block;background:var(--lsai-fill);color:#ffffff!important;font-weight:600;font-size:0.9rem;border:1px solid var(--lsai-green);border-radius:6px;padding:6px 14px;text-decoration:none!important;cursor:pointer;line-height:1.4}.lsai-btn:hover{background:var(--lsai-fill-hover);border-color:var(--lsai-green-dark)}.lsai-btn-outline{background:transparent;color:var(--lsai-green)!important}.lsai-btn-outline:hover{background:var(--lsai-green-soft)}.lsai-buttons{display:flex;flex-wrap:wrap;gap:8px;margin:8px 0}.lsai-grid-2{display:grid;grid-template-columns:repeat(2, 1fr);gap:12px;margin:0 0 8px}.lsai-grid-3{display:grid;grid-template-columns:repeat(3, 1fr);gap:12px;margin:0 0 8px}@media (min-width: 1024px) and (max-width: 1099px){.lsai-grid-3{grid-template-columns:1fr}}.lsai-choice{display:flex;flex-direction:column;border:1px solid var(--lsai-green-line);border-radius:10px;padding:16px;background:var(--lsai-card)}.lsai-choice-title{font-weight:700;font-size:1.02rem;margin-bottom:4px}.lsai-choice-text{color:var(--lsai-muted);font-size:0.93rem;flex:1}.lsai-choice-text p{margin:0 0 6px}.lsai-choice-action{margin-top:12px}.lsai-note{border-left:4px solid #c3ccd4;background:var(--lsai-gray-soft);border-radius:6px;padding:12px 14px;margin:12px 0;font-size:0.95rem}.lsai-note p:last-child{margin-bottom:0}.lsai-note-green{border-left-color:var(--lsai-green);background:var(--lsai-green-soft)}.lsai-note-yellow{border-left-color:var(--lsai-yellow-line);background:var(--lsai-yellow-soft)}.lsai-note-red{border-left-color:var(--lsai-red-line);background:var(--lsai-red-soft)}.lsai-step-text .lsai-note{margin:8px 0 0;font-size:0.9rem}.lsai-copy{margin:0 0 16px}.lsai-copy-label{font-size:0.85rem;color:var(--lsai-muted);margin-bottom:4px}.lsai-copy-row{display:flex;align-items:center;gap:8px;border:1px solid var(--lsai-line);border-radius:8px;background:var(--lsai-gray-soft);padding:6px 6px 6px 12px}.lsai-copy-text{flex:1;min-width:0;font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;font-size:0.95rem;overflow-wrap:anywhere;background:transparent;padding:0}.lsai-copy-button{flex:none;background:var(--lsai-fill);color:#ffffff;border:0;border-radius:6px;padding:6px 14px;font-weight:600;font-size:0.9rem;cursor:pointer}.lsai-copy-button:hover{background:var(--lsai-fill-hover)}.lsai-prompt .lsai-copy-row{align-items:flex-start}.lsai-prompt .lsai-copy-text{white-space:pre-wrap;line-height:1.5}.lsai-test{display:flex;align-items:center;gap:12px;border:1px solid var(--lsai-green-line);background:var(--lsai-green-soft);border-radius:10px;padding:14px 16px;margin:20px 0}.lsai-test-main{flex:1;min-width:0}.lsai-test-title{font-weight:700}.lsai-test-text{font-style:italic}.lsai-test-more{font-size:1rem;color:var(--lsai-ink);margin-top:6px}.lsai-test-more p:last-child{margin-bottom:0}.lsai-test-button{flex:none}.lsai-box{border:1px solid var(--lsai-line);background:var(--lsai-gray-soft);border-radius:10px;padding:16px;margin:16px 0}.lsai-box-title{font-weight:700;margin-bottom:4px}.lsai-box-text p:last-child{margin-bottom:0}.lsai-page [id]{scroll-margin-top:128px}.lsai-box-thumb{max-width:220px;margin-top:12px}.lsai-badge{display:inline-block;font-size:0.75rem;font-weight:700;line-height:1;padding:4px 8px;border-radius:999px;background:var(--lsai-green-soft);color:var(--lsai-green);vertical-align:middle;margin-left:6px}.lsai-grid-2 .lsai-box{margin:0;background:var(--lsai-card)}.lsai-stuck{border-top:1px solid var(--lsai-line);margin-top:28px;padding-top:14px;font-size:0.88rem;color:var(--lsai-muted)}@media (max-width: 760px){.lsai-page{padding:20px 16px 40px}.lsai-title{font-size:1.6rem}.lsai-grid-2,.lsai-grid-3{grid-template-columns:1fr}.lsai-progress-label{display:none}.lsai-progress-now{display:block}.lsai-step{flex-wrap:wrap}.lsai-step-main{flex-basis:calc(100% - 48px)}.lsai-thumbs{width:calc(100% - 48px);margin-left:48px;max-width:360px}.lsai-test{flex-direction:column;align-items:flex-start}}@media (min-width: 1024px) and (min-height: 600px){.lsai-page.lsai-page-pinned{--lsai-nav-h: calc(var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px));padding-top:20px}.lsai-page-pinned .lsai-top{position:sticky;top:var(--lsai-nav-h);z-index:20;margin:0 0 12px;padding:12px 0 11px;background:var(--lsai-bg);border-bottom:1px solid var(--lsai-line)}.lsai-page-pinned .lsai-head{flex-wrap:nowrap}.lsai-page-pinned .lsai-progress{margin-bottom:0}.lsai-page-pinned .lsai-top.lsai-top-stuck{padding-top:8px}.lsai-page-pinned .lsai-top-stuck .lsai-subtitle{display:none}.lsai-page-pinned .lsai-top-stuck .lsai-title{font-size:1.5rem;margin-bottom:0}.lsai-page-pinned .lsai-top-stuck .lsai-head{align-items:center;margin-bottom:8px}.lsai-page-pinned .lsai-top-stuck .lsai-video-button{padding:6px 12px 6px 6px}.lsai-page-pinned .lsai-top-stuck .lsai-video-play{width:28px;height:28px}html:has(.lsai-page-pinned){scroll-padding-top:calc(var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px) + var(--lsai-pinned-h, 110px) + 12px)}.lsai-page.lsai-page-pinned [id]{scroll-margin-top:0}.lsai-page-pinned .lsai-top-stuck .lsai-video-button{scroll-margin-top:calc(-1 * (var(--lsai-pinned-h, 110px) + 12px))}html:has(.lsai-page-pinned) :is(#navbar,#sidebar) :is(a,button,input,[tabindex]){scroll-margin-top:calc(-1 * (var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px) + var(--lsai-pinned-h, 110px) + 12px))}}"}]}
{"page":{"pagePath":"ai/w9-requests","slug":"/ai/w9-requests","pageMetadata":{"title":"Ask vendors for their W-9","description":"Your AI sends W-9 requests to a QuickBooks Online client's vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.","mode":"frame","href":"/ai/w9-requests"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Your AI sends W-9 requests to a QuickBooks Online client’s vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const AiStuck=()=>_jsxs(`div`,{className:`lsai-stuck`,children:[`Stuck? `,_jsx(`a`,{href:`https://ledgersync.com/book-a-demo`,target:`_blank`,rel:`noopener noreferrer`,children:`Book a call with our team`}),` and we'll help you, or email`,` `,_jsx(`a`,{href:`mailto:support@ledgersync.com`,children:`support@ledgersync.com`}),` with the step and what the screen says. Never send passwords or card numbers.`]});const AiEmail=()=>_jsx(`a`,{href:`mailto:support@ledgersync.com`,children:`support@ledgersync.com`});const AiNote=({tone,children})=>_jsx(`div`,{className:`lsai-note lsai-note-`+(tone||`gray`),children});const AiStep=({id,n,total,label,title,img,caption,imgs,stage,children})=>{const _components={a:`a`,..._provideComponents()};const[open,setOpen]=useState(null);const closeRef=useRef(null);const openerRef=useRef(null);useEffect(()=>{if(!open)return undefined;const root=document.documentElement;const overflow=root.style.overflow;root.style.overflow=`hidden`;if(closeRef.current)closeRef.current.focus({preventScroll:true});return()=>{root.style.overflow=overflow;if(openerRef.current)openerRef.current.focus({preventScroll:true})}},[open]);const pictures=imgs||(img?[{src:img,caption}]:[]);return _jsxs(`div`,{className:`lsai-step`,id,\"data-stage\":stage,children:[_jsx(`div`,{className:`lsai-step-num`,\"aria-hidden\":`true`,children:n}),_jsxs(`div`,{className:`lsai-step-main`,children:[_jsx(`div`,{className:`lsai-step-label`,children:label||`Step `+n+` of `+total}),_jsx(`div`,{className:`lsai-step-title`,children:title}),_jsx(`div`,{className:`lsai-step-text`,children})]}),pictures.length>0\u0026\u0026_jsx(`div`,{className:`lsai-thumbs`,children:pictures.map(pic=>_jsxs(_components.a,{className:`lsai-thumb`,href:pic.src,title:`Click to see it larger`,onClick:e=>{e.preventDefault();openerRef.current=e.currentTarget;setOpen(pic)},children:[_jsx(`img`,{src:pic.src,alt:``,loading:`lazy`}),_jsxs(`span`,{className:`lsai-thumb-caption`,children:[pic.caption?pic.caption+` · `:``,`click to enlarge`]})]},pic.src))}),open\u0026\u0026_jsxs(`div`,{className:`lsai-lightbox`,role:`dialog`,\"aria-modal\":`true`,\"aria-label\":open.caption||title,onClick:e=>{if(e.detail\u003c2)setOpen(null)},onKeyDown:e=>{if(e.key===`Escape`)setOpen(null);if(e.key===`Tab`)e.preventDefault()},children:[_jsx(`button`,{ref:closeRef,type:`button`,className:`lsai-lightbox-close`,onClick:()=>setOpen(null),children:`Close`}),_jsx(`img`,{src:open.src,alt:open.caption||title}),_jsxs(`span`,{className:`lsai-lightbox-note`,children:[open.caption?open.caption+` · `:``,`Click anywhere to close`]})]})]})};const AiPage=({title,subtitle,video,poster,stage,children})=>{const[playing,setPlaying]=useState(false);const[current,setCurrent]=useState(stage);const pageRef=useRef(null);const markRef=useRef(null);const topRef=useRef(null);const watchRef=useRef(null);const closeRef=useRef(null);useEffect(()=>{if(!stage||!topRef.current||!pageRef.current)return undefined;const page=pageRef.current;const top=topRef.current;let frame=0;const update=()=>{frame=0;const css=getComputedStyle(top);const stuck=css.position===`sticky`\u0026\u0026markRef.current.getBoundingClientRect().top\u003c(parseFloat(css.top)||0);if(stuck!==top.classList.contains(`lsai-top-stuck`)){const root=document.documentElement;root.style.overflowAnchor=`none`;requestAnimationFrame(()=>requestAnimationFrame(()=>{root.style.overflowAnchor=``}));if(stuck){const before=top.offsetHeight;const margin=parseFloat(css.marginBottom)||0;top.style.marginBottom=margin+before+`px`;top.classList.add(`lsai-top-stuck`);top.style.marginBottom=margin+before-top.offsetHeight+`px`}else{top.classList.remove(`lsai-top-stuck`);top.style.marginBottom=``}}const atEnd=window.innerHeight+window.scrollY>=document.documentElement.scrollHeight-8;const line=atEnd?Infinity:top.getBoundingClientRect().bottom+120;if(stuck){const height=top.offsetHeight+`px`;if(document.documentElement.style.getPropertyValue(`--lsai-pinned-h`)!==height){document.documentElement.style.setProperty(`--lsai-pinned-h`,height)}}let next=stage;page.querySelectorAll(`[data-stage]`).forEach(el=>{if(el.getBoundingClientRect().top\u003cline)next=Number(el.getAttribute(`data-stage`))});setCurrent(next)};const schedule=()=>{if(!frame)frame=requestAnimationFrame(update)};const reset=()=>{top.classList.remove(`lsai-top-stuck`);top.style.marginBottom=``;schedule()};const observer=typeof ResizeObserver===`undefined`?null:new ResizeObserver(schedule);if(observer){observer.observe(top,{box:`border-box`});observer.observe(page)}window.addEventListener(`scroll`,schedule,{passive:true});window.addEventListener(`resize`,reset);update();return()=>{document.documentElement.style.removeProperty(`--lsai-pinned-h`);if(observer)observer.disconnect();window.removeEventListener(`scroll`,schedule);window.removeEventListener(`resize`,reset);if(frame)cancelAnimationFrame(frame)}},[stage,title]);useEffect(()=>{if(!playing)return undefined;const root=document.documentElement;const overflow=root.style.overflow;root.style.overflow=`hidden`;if(closeRef.current)closeRef.current.focus({preventScroll:true});return()=>{root.style.overflow=overflow;if(watchRef.current)watchRef.current.focus({preventScroll:true})}},[playing]);const stages=[`Get ready`,`Add it to your AI`,`Sign in`,`Click Allow`,`Ask a question`];return _jsxs(`div`,{ref:pageRef,className:stage?`lsai-page lsai-page-pinned`:`lsai-page`,children:[_jsx(`div`,{ref:markRef,className:`lsai-top-mark`,\"aria-hidden\":`true`}),_jsxs(`div`,{ref:topRef,className:`lsai-top`,children:[_jsxs(`div`,{className:`lsai-head`,children:[_jsxs(`div`,{className:`lsai-head-text`,children:[_jsx(`h1`,{className:`lsai-title`,children:title}),subtitle\u0026\u0026_jsx(`p`,{className:`lsai-subtitle`,children:subtitle})]}),video\u0026\u0026_jsxs(`button`,{ref:watchRef,type:`button`,className:`lsai-video-button`,onClick:()=>setPlaying(true),children:[_jsx(`span`,{className:`lsai-video-play`,\"aria-hidden\":`true`,children:`▶`}),_jsxs(`span`,{className:`lsai-video-label`,children:[_jsx(`strong`,{children:`Watch it first`}),_jsx(`span`,{children:`Short setup video`})]})]})]}),stage\u0026\u0026_jsxs(`div`,{className:`lsai-progress-wrap`,children:[_jsx(`ol`,{className:`lsai-progress`,\"aria-label\":`Setup progress`,children:stages.map((label,i)=>{const n=i+1;const state=n\u003ccurrent?`lsai-done`:n===current?`lsai-current`:`lsai-todo`;return _jsxs(`li`,{className:`lsai-progress-item `+state,\"aria-current\":n===current?`step`:undefined,children:[_jsx(`span`,{className:`lsai-progress-bar`}),_jsx(`span`,{className:`lsai-progress-label`,children:label})]},label)})}),_jsx(`div`,{className:`lsai-progress-now`,children:stages[current-1]})]})]}),playing\u0026\u0026_jsxs(`div`,{className:`lsai-lightbox lsai-video-box`,role:`dialog`,\"aria-modal\":`true`,\"aria-label\":title+`: setup video`,tabIndex:-1,onClick:e=>{if(e.target===e.currentTarget)setPlaying(false)},onKeyDown:e=>{if(e.key===`Escape`)setPlaying(false);if(e.key===`Tab`){e.preventDefault();const close=e.currentTarget.querySelector(`button`);(document.activeElement===close?e.currentTarget.querySelector(`video`):close).focus({preventScroll:true})}},children:[_jsx(`button`,{ref:closeRef,type:`button`,className:`lsai-lightbox-close`,onClick:()=>setPlaying(false),children:`Close`}),_jsx(`video`,{className:`lsai-video-player`,controls:true,autoPlay:true,playsInline:true,tabIndex:0,poster,src:video}),_jsx(`span`,{className:`lsai-lightbox-note`,children:`Click Close when you are done`})]}),children]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,h2:`h2`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Table,_MdxComponentBoundary}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Table)_missingMdxReference(`Table`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsx(_MdxComponentBoundary,{name:`AiPage`,children:_jsxs(AiPage,{title:`Ask vendors for their W-9`,subtitle:`Ask your AI. After your yes, LedgerSync emails each vendor a secure link to fill in and sign their W-9, and you download the finished form.`,children:[_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`green`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`For QuickBooks Online clients.`}),` Not set up yet? Go to `,_jsx(_components.a,{href:`/ai/start-here`,children:`Start here`}),`. Added it a while ago? Do\n`,_jsx(_components.a,{href:`/ai/troubleshooting#after-an-update`,children:`After a LedgerSync update`}),` once.`]})})}),_jsx(_components.h2,{children:`Start`}),_jsx(_MdxComponentBoundary,{name:`AiStep`,children:_jsx(AiStep,{id:`new-chat`,n:1,total:5,title:`Start a new chat`,children:_jsxs(_components.p,{children:[`In Claude, ChatGPT or Grok. In ChatGPT, also type `,_jsx(_components.strong,{children:`@`}),` and pick `,_jsx(_components.strong,{children:`LedgerSync`}),`.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiStep`,children:_jsx(AiStep,{id:`ask`,n:2,total:5,title:`Ask the AI`,children:_jsxs(_components.p,{children:[`Type `,_jsx(_components.em,{children:`“Send W-9 requests to Acme’s vendors with no tax ID on file”`}),`, with your client’s name, and press `,_jsx(_components.strong,{children:`Enter`}),`.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiStep`,children:_jsx(AiStep,{id:`check`,n:3,total:5,title:`Check the preview`,children:_jsx(_components.p,{children:`The AI shows who gets a request and at which email address, the email as each vendor will read it, and the vendors\nit leaves out, with the reason. Nothing is sent yet.`})})}),_jsx(_MdxComponentBoundary,{name:`AiStep`,children:_jsx(AiStep,{id:`yes`,n:4,total:5,title:`Say yes`,children:_jsx(_components.p,{children:`Say yes, and allow it each time Claude or ChatGPT asks. LedgerSync emails each vendor from its own address, under\nyour firm’s name. When a vendor replies, the reply comes to you.`})})}),_jsx(_MdxComponentBoundary,{name:`AiStep`,children:_jsx(AiStep,{id:`follow`,n:5,total:5,title:`Get the finished W-9s`,children:_jsxs(_components.p,{children:[`A few days later, ask `,_jsx(_components.em,{children:`“Who has sent their W-9 for Acme?”`}),`. The AI says where each request stands. For a vendor who\nfinished theirs, ask for the W-9: the AI gives you a link that downloads it as a PDF.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`green`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The vendor fills in the form online.`}),` They answer one question at a time, in the official form’s words, and sign\nby typing their name. Their link works for 30 days.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`green`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Tax IDs are never shown in the chat.`}),` The vendor types theirs only on LedgerSync’s secure page, and LedgerSync\nkeeps it encrypted. Don’t type a tax ID in the chat.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`yellow`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Keep your own copy.`}),` LedgerSync deletes a client’s W-9s when the client is deleted. Download the ones you keep.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`yellow`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Using Grok?`}),` Tell it to wait for your yes before it sends anything.`]})})}),_jsx(_components.h2,{children:`More details`}),_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`What happens after you ask`,id:`what-happens-after-you-ask`,children:[_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`The AI finds the client and reads the client’s 1099 list from QuickBooks: the vendors with no tax ID on file,\nand whether LedgerSync already asked each one for a W-9.`}),`\n`,_jsx(_components.li,{children:`It shows you a preview: each vendor who gets a request and the email address it goes to, the one in QuickBooks or\none you give it. It also shows the email as the vendor will read it, and the vendors it leaves out, with the\nreason: for example no email address, a request already waiting, or a W-9 already completed. Nothing has been\nsent.`}),`\n`,_jsx(_components.li,{children:`You say yes. Claude and ChatGPT also ask you to allow it: allow it if the preview looked right. LedgerSync emails\neach vendor from its own address as “(your firm) via LedgerSync”. The email says your client needs their Form W-9\nfor their 1099 filing, and that your firm collects it on LedgerSync’s secure page. Replies reach the person who\nsent the requests.`}),`\n`,_jsxs(_components.li,{children:[`The vendor clicks `,_jsx(_components.strong,{children:`Fill in my W-9`}),`, fills in the form one step at a time, and signs by typing their name. Their\nlink works for 30 days.`]}),`\n`,_jsx(_components.li,{children:`Ask the AI where the requests stand. For each vendor it says sent, opened, completed, expired, cancelled, replaced\nby a newer request, or bounced. The 1099 list shows the same for each vendor, and the client summary says how many\nrequests are still waiting on vendors.`}),`\n`,_jsxs(_components.li,{children:[`Ask for a vendor’s finished W-9. The AI gives you a link that works once, within 10 minutes. It opens a page with\na `,_jsx(_components.strong,{children:`Download W-9`}),` button. The PDF is the official IRS Form W-9 with the vendor’s answers and typed signature. It\nnever passes through the chat.`]}),`\n`,_jsx(_components.li,{children:`No answer after a week? Ask the AI to remind them. A reminder goes to a vendor last emailed more than 7 days ago,\nwith a new link.`}),`\n`,_jsx(_components.li,{children:`Wrong email address? Give the AI the right one: it cancels the waiting request and sends a new one there. Need a\nnew W-9 from a vendor, for example because the IRS said the tax ID was wrong? Ask the AI to ask them again, and say\nwhy: the vendor reads your reason in the email. You can also ask the AI to cancel a request.`}),`\n`]}),_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`gray`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Optional: save each W-9 to QuickBooks.`}),` When you send the requests, you can ask the AI to also save each W-9 to\nQuickBooks once the vendor signs. LedgerSync then marks the vendor for 1099 and saves their tax ID, unless QuickBooks\nalready has a different one, which it leaves for you to compare with the W-9. The AI’s list of W-9 requests shows how\neach save went. You can undo the 1099 mark; QuickBooks keeps the tax ID.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`gray`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`What the vendor’s email says.`}),` The subject is “W-9 request from” and your client’s name. The email also says\nLedgerSync never asks for a tax ID by email or phone, and that the vendor should enter theirs only on the secure page\nthe link opens.`]})})}),_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`gray`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`How many a day.`}),` Your firm can send up to 300 W-9 emails a day, everyone at the firm and every AI app together.\nFirst requests, reminders, corrected addresses and requests sent again all count. A cancel sends no email and does\nnot count.`]})})})]}),_jsx(Accordion,{title:`What it does not cover`,id:`what-it-does-not-cover`,children:_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Filing. File the 1099s through your usual 1099 service.`}),`\n`,_jsx(_components.li,{children:`Checking a vendor’s tax ID with the IRS.`}),`\n`,_jsx(_components.li,{children:`Forms for vendors outside the U.S., such as the W-8. The W-9 is for U.S. persons.`}),`\n`,_jsx(_components.li,{children:`Reminders on their own. The AI sends a reminder when you ask for one.`}),`\n`,_jsx(_components.li,{children:`Clients that use another accounting app, such as QuickBooks Desktop or Zoho Books.`}),`\n`]})}),_jsx(Accordion,{title:`Before you start`,id:`before-you-start`,children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LedgerSync is in your AI app:`}),` Claude, ChatGPT or Grok. Not yet? Go to `,_jsx(_components.a,{href:`/ai/start-here`,children:`Start here`}),`. Added it\na while ago? Do `,_jsx(_components.a,{href:`/ai/troubleshooting#after-an-update`,children:`After a LedgerSync update`}),` once, so your AI gets the W-9\ntools.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The client is connected to QuickBooks in LedgerSync`}),`, the same connection you use to sync transactions from\nthe LedgerSync app.`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`The client uses QuickBooks Online.`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Each vendor has an email address in QuickBooks.`}),` No address there? Give the AI the one to use.`]}),`\n`]})}),_jsx(Accordion,{title:`Your client's data`,id:`your-clients-data`,children:_jsx(_MdxComponentBoundary,{name:`AiNote`,children:_jsx(AiNote,{tone:`yellow`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Your client’s vendors go through your AI account.`}),` The AI app reads the client’s vendors, their email addresses\nand where each W-9 request stands, and keeps the chat under your AI account’s settings. Check that account’s data\nsettings before you start. Tax IDs never reach the chat: it only says whether one came in.`]})})})}),_jsx(Accordion,{title:`Optional: the full instructions to paste`,id:`optional-the-full-instructions-to-paste`,children:_jsxs(_components.p,{children:[`You don’t need these: LedgerSync already gives your AI the same steps. The W-9 steps are part of the 1099\ninstructions: see `,_jsx(_components.a,{href:`/ai/1099-vendors`,children:`Find who needs a 1099`}),`, under `,_jsx(_components.strong,{children:`Optional: the full instructions to paste`}),`.`]})})]}),_jsx(_components.h2,{children:`If something goes wrong`}),_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Most common messages`,id:`most-common-messages`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`The AI says`}),_jsx(_components.th,{children:`Do this`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`It doesn’t know how to do this`}),_jsxs(_components.td,{children:[`Your AI may still have an older copy of LedgerSync’s tools. Do `,_jsx(_components.a,{href:`/ai/troubleshooting#after-an-update`,children:`After a LedgerSync update`}),`, then start a new chat.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sending W-9 requests from an AI app is open to a few test firms first.`})}),_jsx(_components.td,{children:`Every firm can send W-9 requests on the live LedgerSync connector; only the sandbox (test) connector still says this. Ask those vendors for their W-9 directly for now. The 1099 list still shows who needs one.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`QuickBooks holds no email address for this vendor.`})}),_jsx(_components.td,{children:`Give the AI the vendor’s email address, and ask it to preview again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`The vendor already has an open W-9 request.`})}),_jsx(_components.td,{children:`Ask the AI to remind them, to send it to a corrected address, or to cancel it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`The vendor was emailed a W-9 request in the last 7 days.`})}),_jsx(_components.td,{children:`Wait: a reminder can go once 7 days have passed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`The vendor already completed a W-9.`})}),_jsx(_components.td,{children:`Ask the AI for the finished W-9. To ask for a new one, tell the AI why: the vendor reads your reason.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`The vendor is inactive in QuickBooks.`})}),_jsx(_components.td,{children:`Make the vendor active in QuickBooks, then ask the AI to preview again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your firm reached today’s limit of W-9 emails. Send the rest tomorrow.`})}),_jsx(_components.td,{children:`Ask the AI to send the rest tomorrow.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`QuickBooks did not answer LedgerSync just now.`})}),_jsx(_components.td,{children:`Nothing was sent for those vendors. Ask again in a few minutes.`})]})]})]})}),_jsx(Accordion,{title:`More messages: preview expired, send already running, read-only, download link used`,id:`more-messages-preview-expired-send-already-running-read-only-download-link-used`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`The AI says`}),_jsx(_components.th,{children:`Do this`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`This confirmation is unknown or expired. Preview the W-9 requests again.`})}),_jsx(_components.td,{children:`A preview works for 30 minutes. Ask the AI to preview again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Another send is running; try again in a minute.`})}),_jsx(_components.td,{children:`Wait a minute, then ask the AI to send again.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`This connection is read-only or lacks permission for this action.`})}),_jsxs(_components.td,{children:[`This connection can read but not send. Ask your vendors for their W-9 directly, or email `,_jsx(_MdxComponentBoundary,{name:`AiEmail`,children:_jsx(AiEmail,{})}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`The download page says `,_jsx(_components.strong,{children:`This link was already used`}),` or `,_jsx(_components.strong,{children:`This link has expired`})]}),_jsx(_components.td,{children:`Each link works once, for 10 minutes. Ask the AI for a new link.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`It cannot find the client`}),_jsx(_components.td,{children:`Ask “Find my client …” first. Not the firm owner or an administrator? You see only the clients assigned to you in LedgerSync.`})]})]})]})})]}),_jsxs(_components.p,{children:[`Anything else? See `,_jsx(_components.a,{href:`/ai/troubleshooting`,children:`Troubleshooting`}),`.`]}),_jsx(AccordionGroup,{children:_jsxs(Accordion,{title:`For developers: the 4 tools and what they change`,id:`for-developers-the-4-tools-and-what-they-change`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`What it does`}),_jsx(_components.th,{children:`Changes data`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_preview_w9_requests`})}),_jsx(_components.td,{children:`Checks W-9 requests to up to 50 of a QuickBooks client’s vendors, picked from the 1099 list: the address each email would go to, the vendors it would leave out and why, and the email as the vendor would read it; also reminders, a corrected address, asking a vendor again and cancelling`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_send_w9_requests`})}),_jsx(_components.td,{children:`Emails the previewed W-9 requests from LedgerSync’s address in the firm’s name, each with the vendor’s own secure link`}),_jsx(_components.td,{children:`Yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_list_w9_requests`})}),_jsx(_components.td,{children:`Where each of a client’s W-9 requests stands, and how each W-9’s save to QuickBooks went when it was chosen; never a tax ID`}),_jsx(_components.td,{children:`No`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ledgersync_get_w9_download_link`})}),_jsx(_components.td,{children:`One-time link, good for 10 minutes, to a vendor’s completed W-9 as the official IRS form in PDF`}),_jsx(_components.td,{children:`No`})]})]})]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The preview needs `,_jsx(_components.code,{children:`write:accounting`}),`, and only firms W-9 requests are open to may preview and send: every firm on\nlive; on the sandbox connector still test firms only, and any other firm there gets `,_jsx(_components.code,{children:`access_not_active`}),`. The\nlist and the download link need `,_jsx(_components.code,{children:`read:accounting`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`The 1099 list (`,_jsx(_components.code,{children:`ledgersync_get_1099_summary`}),`) shows each vendor’s `,_jsx(_components.code,{children:`w9_status`}),`, and the client snapshot\n(`,_jsx(_components.code,{children:`ledgersync_get_client_snapshot`}),`) returns `,_jsx(_components.code,{children:`open_w9_requests`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`See `,_jsx(_components.a,{href:`/ai/developers`,children:`For developers`}),` for every field.`]}),`\n`]})]})}),_jsx(_MdxComponentBoundary,{name:`AiStuck`,children:_jsx(AiStuck,{})})]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{AiStuck,AiEmail,AiNote,AiStep,AiPage,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Ask vendors for their W-9","description":"Your AI sends W-9 requests to a QuickBooks Online client's vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.","mode":"frame","href":"/ai/w9-requests"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[117,131,"Note=()=>null;const AiStep=()=>null;const AiPage=()=>null;const AiStuck=()=>_jsx"],[620,7523,""],[26412,26452,"Note,AiStep,AiPage,AiStuck,AiEmail,defau"]]},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ledgersync/6ae4be936c1d0f9f/ai-connector.js"],"subdomain":"ledgersync","siteName":"LedgerSync","title":"Ask vendors for their W-9 - LedgerSync","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T23:18:11.125Z","originalFileLocation":"ai/w9-requests.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Your AI sends W-9 requests to a QuickBooks Online client\u0026#x27;s vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LedgerSync\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ask vendors for their W-9 - LedgerSync\">\u003cmeta data-mint-head property=\"og:description\" content=\"Your AI sends W-9 requests to a QuickBooks Online client\u0026#x27;s vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LedgerSync\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ledgersyncappv2.com/ai/w9-requests\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ledgersync.mintlify.site/_mintlify/api/og/v2?division=LedgerSync+MCP\u0026amp;title=Ask+vendors+for+their+W-9\u0026amp;description=Your+AI+sends+W-9+requests+to+a+QuickBooks+Online+client%27s+vendors.+Each+vendor+fills+in+and+signs+the+official+form+on+a+secure+LedgerSync+page%2C+and+you+downlo\u0026amp;theme=bcd469bc79d7c9d0510611ec\u0026amp;signature=6c560364cfc4576e37f844efd0d2a3923efd9d9eb5d7ac5c8f5f90a827f95709\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Ask vendors for their W-9 - LedgerSync\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Your AI sends W-9 requests to a QuickBooks Online client\u0026#x27;s vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ledgersync.mintlify.site/_mintlify/api/og/v2?division=LedgerSync+MCP\u0026amp;title=Ask+vendors+for+their+W-9\u0026amp;description=Your+AI+sends+W-9+requests+to+a+QuickBooks+Online+client%27s+vendors.+Each+vendor+fills+in+and+signs+the+official+form+on+a+secure+LedgerSync+page%2C+and+you+downlo\u0026amp;theme=bcd469bc79d7c9d0510611ec\u0026amp;signature=6c560364cfc4576e37f844efd0d2a3923efd9d9eb5d7ac5c8f5f90a827f95709\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ledgersync/_Z9OSrCeUvX_nsj4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LedgerSync\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0891B2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ledgersyncappv2.com/ai/w9-requests\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai/w9-requests.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ledgersyncappv2.com/#organization\",\"name\":\"LedgerSync\",\"url\":\"https://docs.ledgersyncappv2.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ledgersync/NVbCdX0lsP_TgYmH/logo/ledgersync-wordmark.png?fit=max\u0026auto=format\u0026n=NVbCdX0lsP_TgYmH\u0026q=85\u0026s=b149d57dc2f40804f937b11e31060496\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ledgersyncappv2.com#website\",\"name\":\"LedgerSync\",\"url\":\"https://docs.ledgersyncappv2.com\",\"publisher\":{\"@id\":\"https://docs.ledgersyncappv2.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ledgersyncappv2.com/ai/w9-requests#webpage\",\"url\":\"https://docs.ledgersyncappv2.com/ai/w9-requests\",\"name\":\"Ask vendors for their W-9\",\"description\":\"Your AI sends W-9 requests to a QuickBooks Online client's vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.\",\"dateModified\":\"2026-11-17T23:18:11.125Z\",\"isPartOf\":{\"@id\":\"https://docs.ledgersyncappv2.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ledgersyncappv2.com/ai/w9-requests#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ledgersyncappv2.com/ai/w9-requests#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"LedgerSync MCP\",\"item\":\"https://docs.ledgersyncappv2.com/ai/start-here\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ask vendors for their W-9\",\"item\":\"https://docs.ledgersyncappv2.com/ai/w9-requests\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ledgersyncappv2.com/ai/w9-requests#article\",\"headline\":\"Ask vendors for their W-9\",\"name\":\"Ask vendors for their W-9\",\"description\":\"Your AI sends W-9 requests to a QuickBooks Online client's vendors. Each vendor fills in and signs the official form on a secure LedgerSync page, and you download the finished W-9 when you need it.\",\"url\":\"https://docs.ledgersyncappv2.com/ai/w9-requests\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ledgersyncappv2.com/ai/w9-requests#webpage\"},\"dateModified\":\"2026-11-17T23:18:11.125Z\",\"publisher\":{\"@id\":\"https://docs.ledgersyncappv2.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ledgersyncappv2.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LedgerSync\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"LedgerSync\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ai/w9-requests.md","siteName":"LedgerSync","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"LedgerSync MCP","groups":[{"group":"LedgerSync MCP","pages":[{"title":"Use LedgerSync in Claude, ChatGPT or Grok","sidebarTitle":"Start here","mode":"frame","href":"/ai/start-here"},{"title":"Set up in Claude","mode":"frame","href":"/ai/setup-claude"},{"title":"Set up in ChatGPT","mode":"frame","href":"/ai/setup-chatgpt"},{"title":"Set up in Grok","mode":"frame","href":"/ai/setup-grok"},{"title":"Set up in Grok Bot","mode":"frame","href":"/ai/setup-grok-bot"},{"title":"Turn a bank statement PDF into transactions","sidebarTitle":"Convert a statement PDF","mode":"frame","href":"/ai/convert-statement"},{"title":"The CheckList","mode":"frame","href":"/ai/checklist"},{"title":"Bookkeeping into QuickBooks","mode":"frame","href":"/ai/quickbooks-bookkeeping"},{"title":"Set up rules for a client","mode":"frame","href":"/ai/rules-setup"},{"title":"Accept For review transactions","mode":"frame","href":"/ai/accept-transactions"},{"title":"Export categorized transactions on a schedule","sidebarTitle":"Export categorized transactions","mode":"frame","href":"/ai/categorized-export"},{"title":"Find who needs a 1099","description":"Your AI lists the vendors a QuickBooks Online client paid enough to need a 1099, and which ones are not marked for 1099 or have no tax ID on file. It also advises, from the expense accounts each vendor was paid through, which ones look like they need one. After you say yes, LedgerSync marks them for 1099 in QuickBooks.","mode":"frame","href":"/ai/1099-vendors"},{"title":"Ask vendors for their W-9","mode":"frame","href":"/ai/w9-requests"},{"title":"Review a client's books","description":"Your AI checks a month of a QuickBooks Online client's books: entries still waiting for a category, expenses with no payee, entries on a parent account, vendors coded differently than usual, and large amounts. Each one comes with the reason, and a suggested fix when the client's history shows one. Nothing changes in QuickBooks.","mode":"frame","href":"/ai/review-my-client"},{"title":"Explain my reconciliation","mode":"frame","href":"/ai/explain-my-reconciliation"},{"title":"What changed this month","mode":"frame","href":"/ai/what-changed"},{"title":"Check a new client's books","mode":"frame","href":"/ai/new-client-check"},{"title":"Troubleshooting","mode":"frame","href":"/ai/troubleshooting"},{"title":"Banks that need the LedgerSync desktop app","sidebarTitle":"Banks that need the desktop app","mode":"frame","href":"/ai/desktop-app"}]},{"group":"Developers","pages":[{"title":"For developers","mode":"frame","href":"/ai/developers"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"v2 API (legacy)","pages":[{"title":"v2 API (legacy)","href":"/v2/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Ask vendors for their W-9 - LedgerSync","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}