For an example manifest file of a Microsoft integration, visit our samples repo on Github.
Before You Get Started
To connect Microsoft services with Ampersand, you will need a Microsoft Account.Once your account is created, you’ll need to create an app in the Azure portal, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:
Client ID
Client Secret
Scopes
You will then use these credentials to connect your application to Ampersand.
Create a Microsoft Account
Here’s how you can sign up for a Microsoft account:
If your integration has Read Actions, you’ll start getting webhook messages.
If your integration has Write Actions, you can start making API calls to our Write API.
If your integration has Proxy Actions, you can start making Proxy API calls.
In order to receive a refresh token and be able to access your customers’ Microsoft Graph APIs without reauthenticating, you must include the offline_access permission when registering the app with Ampersand
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ampersand","colors":{"primary":"#1F71D6","light":"#F3F89B","dark":"#2B2B2B"},"logo":{"light":"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/light.png?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=7799b7c055eff93e5275bfee4335494b","dark":"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/dark.png?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=e83684af7f0f30de3c40d300c6e38ecf","href":"https://www.ampersand.ai"},"favicon":"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/favicon.svg?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=a58cf520454ff09433cb78f5ce10b2f2","api":{"openapi":["platform.json","read.json","write.json","search.json"]},"background":{"color":{"light":"#FDFBF9","dark":"#121212"}},"navbar":{"links":[{"href":"https://dashboard.withampersand.com/sign-in?trk=docs","label":"Sign in"}],"primary":{"type":"button","label":"Start building now","href":"https://dashboard.withampersand.com/sign-up?trk=docs"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/withampersand","twitter":"https://twitter.com/withampersand"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"Helvetica Neue","weight":600,"source":"fonts/HelveticaNeue/HelveticaNeueMedium.woff2","format":"woff2"},"body":{"family":"Helvetica Neue","weight":500,"source":"fonts/HelveticaNeue/HelveticaNeueRoman.woff2","format":"woff2"}},"styling":{"codeblocks":"dark","latex":false},"integrations":{"gtm":{"tagId":"GTM-KKG4NLZD"}},"contextual":{"options":["copy","view"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ampersand-24eb5c1a","hasAudioNarration":false,"actualSubdomain":"ampersand-24eb5c1a","customDomains":["docs.ampersand.ai"],"gitSource":{"type":"github","owner":"amp-labs","repo":"docs","deployBranch":"main","contentDirectory":"src","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afba4d88ec88c31b27205a9","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Integrations","count":434},{"language":"default","tag":"All providers","count":203},{"language":"default","tag":"API Reference","count":91},{"language":"default","tag":"PLATFORM API","count":82},{"language":"default","tag":"Guides","count":37},{"language":"default","tag":"Customer guides","count":13},{"language":"default","tag":"Destinations","count":13},{"language":"default","tag":"Destination","count":12},{"language":"default","tag":"Org","count":12},{"language":"default","tag":"Installation","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"troubleshooting.css","content":".amp-ts{margin-top:1.5rem;letter-spacing:-0.0125rem}.amp-ts [hidden]{display:none!important}.amp-ts-controls{display:flex;flex-wrap:wrap;gap:10px;align-items:center}.amp-ts input.amp-ts-search{flex:1;min-width:240px;height:38px;padding:0 12px;border-radius:12px;border:1px solid var(--amp-border);background:var(--amp-surface-2);color:var(--amp-fg);font-size:15px;outline:none;transition:border-color 120ms ease}.amp-ts input.amp-ts-search:focus{border-color:var(--amp-accent)}.amp-ts input.amp-ts-search::placeholder{color:var(--amp-faint)}.amp-ts-chips{display:flex;flex-wrap:wrap;gap:8px}.amp-ts button.amp-ts-chip{height:32px;padding:0 12px;border:1px solid var(--amp-border);border-radius:12px;background:var(--amp-surface);color:var(--amp-muted);font-size:14px;font-family:inherit;cursor:pointer;transition:border-color 120ms ease, color 120ms ease}.amp-ts button.amp-ts-chip:hover{border-color:var(--amp-border-hover);color:var(--amp-fg)}.amp-ts button.amp-ts-chip.is-active{border-color:var(--amp-accent);color:var(--amp-accent)}.amp-ts-list{margin-top:6px}.amp-ts a.amp-ts-row{display:grid;grid-template-columns:minmax(0, 1fr) auto;align-items:center;gap:16px;padding:14px 4px;border-bottom:1px solid var(--amp-border-2);color:inherit;text-decoration:none;border-radius:0}.amp-ts a.amp-ts-row:hover .amp-ts-title{color:var(--amp-accent)}.amp-ts-title{font-size:16px;font-weight:500;color:var(--amp-fg);transition:color 120ms ease}.amp-ts-title code{font-size:13px}.amp-ts-desc{margin-top:4px;font-size:15px;line-height:1.6;color:var(--amp-muted)}.amp-ts-tag{font-family:var(--amp-mono);font-size:12px;color:var(--amp-muted-2);white-space:nowrap}.amp-ts-count{margin-top:12px;font-family:var(--amp-mono);font-size:12px;color:var(--amp-muted-2)}"},{"filePath":"fonts.css","content":"@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueThin.woff2\") format(\"woff2\");font-weight:100;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueLight.woff2\") format(\"woff2\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueRoman.woff2\") format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueMedium.woff2\") format(\"woff2\");font-weight:500 600;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueBold.woff2\") format(\"woff2\");font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueBlack.woff2\") format(\"woff2\");font-weight:900;font-style:normal;font-display:swap}"},{"filePath":"provider-grid.css","content":"html[data-current-path=\"/provider-guides/overview\"] #header{display:none}html[data-current-path=\"/provider-guides/overview\"] .mdx-content{max-width:none;margin-top:0}.amp-intg{max-width:1180px;margin:0 auto;color:var(--amp-fg);line-height:1.5}.amp-intg *{box-sizing:border-box}.amp-intg a{color:inherit;text-decoration:none}.amp-find-status,.amp-orbit-core i,.amp-node-label,.amp-intg-card-code,.amp-intg-card-cta{font-family:var(--amp-mono)}.amp-find-status,.amp-intg-head-sub{color:var(--amp-muted-2)}.amp-intg-eyebrow,.amp-intg-title-accent,.amp-intg-card-code,.amp-intg-card-cta{color:var(--amp-accent)}.amp-find-input,.amp-node a,.amp-node-label,.amp-cat-chips a,.amp-intg-card{border:1px solid var(--amp-border);background:var(--amp-surface)}.amp-cat-chips a:hover,.amp-cat-chips a:focus-visible,.amp-intg-card:hover{border-color:var(--amp-border-hover)}.amp-node a:focus-visible,.amp-cat-head:focus-visible{outline:2px solid var(--amp-accent)}.amp-intg-hero{display:grid;grid-template-columns:minmax(0, 1fr) minmax(0, 1.05fr);gap:56px;align-items:center;padding:40px 0 8px}.amp-intg-eyebrow{font-size:14px;font-weight:500;margin-bottom:12px}.amp-intg h1.amp-intg-title{margin:0;font-size:36px;line-height:44px;letter-spacing:-0.025em;font-weight:600;text-wrap:pretty}.amp-intg p.amp-intg-lede{margin:20px 0 0;font-size:16px;line-height:1.6;color:var(--amp-muted);max-width:46ch;text-wrap:pretty}.amp-find{margin-top:28px;max-width:360px}.amp-find-input{width:100%;height:40px;padding:0 12px;border-radius:8px;color:inherit;font:inherit;font-size:14px;outline:none;transition:border-color 120ms ease}.amp-find-input:focus{border-color:var(--amp-accent)}.amp-find-input::placeholder{color:var(--amp-faint)}.amp-find-status{margin-top:10px;font-size:11.5px;min-height:16px}.amp-orbit{position:relative;width:min(100%, 540px);aspect-ratio:1;margin:0 auto;container-type:inline-size}.amp-orbit::before,.amp-orbit::after{content:\"\";position:absolute;left:50%;top:50%;border-radius:50%;border:1px solid var(--amp-border-2);transform:translate(-50%, -50%);pointer-events:none}.amp-orbit::before{width:52cqw;height:52cqw}.amp-orbit::after{width:86cqw;height:86cqw;border-style:dashed}.amp-orbit-core{position:absolute;left:50%;top:50%;width:15cqw;height:15cqw;transform:translate(-50%, -50%);display:flex;flex-direction:column;align-items:center;justify-content:center;border-radius:50%;background:var(--amp-accent);box-shadow:0 10px 30px var(--amp-accent-soft);transition:transform 200ms ease, box-shadow 200ms ease}.amp-intg a.amp-orbit-core{color:#fff}html.dark .amp-intg a.amp-orbit-core{color:var(--amp-surface)}.amp-orbit-core:hover,.amp-orbit-core:focus-visible{transform:translate(-50%, -50%) scale(1.06);box-shadow:0 14px 36px var(--amp-accent-soft)}.amp-orbit-core b{font-size:4.2cqw;font-weight:600;line-height:1}.amp-orbit-core i{font-size:2.1cqw;font-style:normal;opacity:0.88;line-height:1.5}.amp-node{position:absolute;left:50%;top:50%;transform:translate(-50%, -50%)\n rotate(var(--a))\n translate(var(--r))\n rotate(calc(-1 * var(--a)))}.amp-node a{position:relative;display:grid;place-items:center;width:var(--sz);height:var(--sz);border-radius:50%;transition:transform 200ms cubic-bezier(0.34, 1.4, 0.64, 1), border-color 200ms ease}.amp-node--lg{--sz: 15cqw}.amp-node--sm{--sz: 9.5cqw}.amp-node img{width:62%;height:62%;object-fit:contain;border-radius:6px;background:#ffffff;padding:3%;pointer-events:none}.amp-node a:hover,.amp-node a:focus-visible{border-color:var(--amp-accent)}.amp-node--sm a:hover{transform:scale(1.12)}.amp-node a:focus-visible{outline-offset:3px}.amp-node:has(a:hover),.amp-node:has(a:focus-visible){z-index:3}.amp-node-label{position:absolute;top:calc(100% + 7px);left:50%;transform:translateX(-50%) translateY(3px);padding:3px 9px;border-radius:6px;font-size:11.5px;white-space:nowrap;opacity:0;pointer-events:none;transition:opacity 160ms ease, transform 160ms ease}.amp-node a:hover .amp-node-label,.amp-node a:focus-visible .amp-node-label{opacity:1;transform:translateX(-50%) translateY(0)}.amp-intg-section{padding-top:56px}.amp-intg-section--last{padding-bottom:72px}.amp-intg-head{display:flex;align-items:baseline;gap:14px;padding-bottom:18px;border-bottom:1px solid var(--amp-border-2)}.amp-intg h2.amp-intg-head-title{margin:0;font-size:15px;font-weight:600}.amp-intg-head-sub{font-size:13.5px}.amp-cats{margin-top:8px}.amp-cat{border-bottom:1px solid var(--amp-border-3)}.amp-cat-head{display:grid;grid-template-columns:10px minmax(0, 1fr);align-items:center;gap:14px;padding:17px 4px;cursor:pointer;user-select:none}.amp-cat-head:hover .amp-cat-name,.amp-cat-head:hover .amp-intg-head-title{color:var(--amp-accent)}.amp-cat-head:focus-visible{outline-offset:2px;border-radius:4px}.amp-cat-caret{width:0;height:0;border-left:5px solid var(--amp-faint);border-top:4px solid transparent;border-bottom:4px solid transparent;transition:transform 160ms ease}.amp-cat[data-open=\"true\"] .amp-cat-caret{transform:rotate(90deg);border-left-color:var(--amp-accent)}.amp-cat-name{font-size:14.5px;font-weight:500;letter-spacing:-0.005em;transition:color 120ms ease}.amp-cat:not([data-open=\"true\"]) .amp-cat-chips{display:none}.amp-cat-chips{display:flex;flex-wrap:wrap;gap:8px;padding:2px 4px 22px 24px}.amp-cat--section{border-bottom:0}.amp-intg-head.amp-cat-head{display:flex;align-items:baseline;padding:0 0 18px}.amp-cat--section .amp-cat-caret{align-self:center}.amp-cat--section .amp-cat-chips{padding-top:20px}.amp-cat-chips a{display:inline-flex;align-items:center;height:32px;padding:0 12px;border-radius:7px;font-size:13px;color:var(--amp-fg-2);white-space:nowrap;transition:border-color 120ms ease, color 120ms ease}.amp-cat-chips a:hover,.amp-cat-chips a:focus-visible{color:var(--amp-fg)}.amp-intg-cards{display:grid;grid-template-columns:repeat(auto-fit, minmax(260px, 1fr));gap:16px;margin-top:20px}.amp-intg-card{display:block;padding:20px;border-radius:10px;transition:border-color 120ms ease}.amp-intg-card-code{font-size:13.5px}.amp-intg-card-title{margin-top:10px;font-size:15px;font-weight:600;letter-spacing:-0.01em}.amp-intg-card-desc{margin-top:7px;font-size:14px;line-height:1.55;color:var(--amp-muted)}.amp-intg-card-cta{margin-top:14px;font-size:11.5px}@media (max-width: 960px){.amp-intg-hero{grid-template-columns:minmax(0, 1fr);gap:36px}.amp-intg h1.amp-intg-title{font-size:30px;line-height:38px}}@media (max-width: 640px){.amp-intg h1.amp-intg-title{font-size:27px;line-height:34px}.amp-intg-head{flex-direction:column;align-items:flex-start;gap:6px}.amp-cat-chips{padding-left:4px}}@media (prefers-reduced-motion: no-preference){.amp-node a{animation:amp-bob 6s ease-in-out infinite;animation-delay:var(--d, 0s)}.amp-node a:hover,.amp-node a:focus-visible{animation-play-state:paused}.amp-orbit::after{animation:amp-spin 90s linear infinite}}@keyframes amp-bob{0%,100%{translate:0 0}50%{translate:0 -5px}}@keyframes amp-spin{from{transform:translate(-50%, -50%) rotate(0deg)}to{transform:translate(-50%, -50%) rotate(360deg)}}@media (prefers-reduced-motion: reduce){.amp-node a{animation:none;transition:border-color 160ms ease}.amp-node--sm a:hover{transform:none}.amp-orbit::after{animation:none}.amp-cat-caret{transition:none}.amp-orbit-core:hover,.amp-orbit-core:focus-visible{transform:translate(-50%, -50%)}}.amp-cat[hidden],.amp-cat-chips a[hidden]{display:none!important}"},{"filePath":"shared-variables.css","content":":root{--amp-fg: rgb(var(--gray-900));--amp-fg-2: rgb(var(--gray-700));--amp-muted: rgb(var(--gray-600));--amp-muted-2: rgb(var(--gray-500));--amp-faint: rgb(var(--gray-400));--amp-accent: rgb(var(--primary));--amp-accent-hover: rgb(var(--primary-dark));--amp-accent-soft: rgb(var(--primary) / 0.16);--amp-surface: rgb(var(--background-light));--amp-surface-2: rgb(var(--gray-950) / 0.04);--amp-border: rgb(var(--gray-950) / 0.1);--amp-border-2: rgb(var(--gray-950) / 0.07);--amp-border-3: rgb(var(--gray-950) / 0.05);--amp-border-hover: rgb(var(--gray-950) / 0.22);--amp-mono: var(--font-family-mono-custom, var(--font-jetbrains-mono, ui-monospace)),\n \"SF Mono\", SFMono-Regular, Menlo, monospace}html.dark{--amp-fg: rgb(var(--gray-100));--amp-fg-2: rgb(var(--gray-300));--amp-muted: rgb(var(--gray-400));--amp-muted-2: rgb(var(--gray-400));--amp-faint: rgb(var(--gray-500));--amp-accent: rgb(var(--primary-light));--amp-accent-hover: rgb(var(--primary-light));--amp-accent-soft: rgb(var(--primary-light) / 0.22);--amp-surface: rgb(var(--background-dark));--amp-surface-2: rgb(255 255 255 / 0.05);--amp-border: rgb(255 255 255 / 0.13);--amp-border-2: rgb(255 255 255 / 0.09);--amp-border-3: rgb(255 255 255 / 0.07);--amp-border-hover: rgb(255 255 255 / 0.3)}"}],"page":{"pagePath":"provider-guides/microsoft","slug":"/provider-guides/microsoft","pageMetadata":{"title":"Microsoft","slug":"microsoft","excerpt":"","createdAt":"Sun Jul 21 2024 07:33:01 GMT+0000 (Coordinated Universal Time)","updatedAt":"Wed Jul 31 2024 08:13:04 GMT+0000 (Coordinated Universal Time)","description":null,"href":"/provider-guides/microsoft"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const rows=[{label:`calendars`,read:true,write:true,subscribe:false,href:`https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0`},{label:`me/events`,read:true,write:true,subscribe:true,href:`https://learn.microsoft.com/en-us/graph/api/resources/event?view=graph-rest-1.0`},{label:`me/messages`,read:true,write:true,subscribe:true,href:`https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0`},{label:`users`,read:true,write:true,subscribe:true,href:`https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0`},{label:`AMPERSAND-sentMessages`,read:true,write:false,subscribe:false,display:`MailFolder: Sent items.`,href:`https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0`},{label:`AMPERSAND-messages`,read:true,write:true,subscribe:false,display:`MailFolder: Inbox. Write sends an email.`,href:`https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0`},{label:`AMPERSAND-drafts`,read:true,write:true,subscribe:false,display:`MailFolder: Drafts.`,href:`https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0`}];const Check=()=>_jsx(`span`,{children:`✅`});const Cross=()=>_jsx(`span`,{children:`🚫`});function renderCellValue(value){if(typeof value===`boolean`){return value?_jsx(Check,{}):_jsx(Cross,{})}if(typeof value===`string`\u0026\u0026value.startsWith(`\u003c`)){return _jsx(`span`,{dangerouslySetInnerHTML:{__html:value}})}return value}function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,OptimizedImage,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The Microsoft connector supports all products which are a part of the Microsoft Graph API. These include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`OneDrive`}),`\n`,_jsx(_components.li,{children:`SharePoint`}),`\n`,_jsx(_components.li,{children:`Outlook`}),`\n`,_jsx(_components.li,{children:`OneNote`}),`\n`,_jsx(_components.li,{children:`Teams`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`For a full list of supported products, refer to `,_jsx(_components.a,{href:`https://learn.microsoft.com/en-us/graph/overview-major-services`,children:`Microsoft documentation`}),`.`]}),`\n`,_jsx(_components.p,{children:`We also have connectors for:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/provider-guides/dynamicsCRM`,children:`Dynamics CRM`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/provider-guides/dynamicsBusinessCentral`,children:`Dynamics Business Central`})}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-supported`,children:`What’s Supported`}),`\n`,_jsx(Heading,{level:`3`,id:`supported-actions`,children:`Supported Actions`}),`\n`,_jsx(_components.p,{children:`This connector supports:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/read-actions`,children:`Read Actions`}),`, including full historic backfill and incremental read.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/subscribe-actions`,children:`Subscribe Actions`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/write-actions`,children:`Write Actions`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/proxy-actions`,children:`Proxy Actions`}),`, using the base URL `,_jsx(_components.code,{children:`https://graph.microsoft.com`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`supported-objects`,children:`Supported Objects`}),`\n`,_jsxs(_components.p,{children:[`The Microsoft Graph connector supports `,_jsx(_components.strong,{children:`many Microsoft Graph API objects`}),` including but not limited to:`]}),`\n`,`\n`,`\n`,`\n`,_jsx(`div`,{style:{width:`100%`,overflowX:`auto`,display:`block`},children:_jsxs(`table`,{style:{width:`100%`,minWidth:`100%`,tableLayout:`fixed`,textAlign:`center`,borderCollapse:`collapse`,display:`table`},children:[_jsx(`thead`,{style:{display:`table-header-group`,width:`100%`},children:_jsxs(`tr`,{style:{display:`table-row`,width:`100%`},children:[_jsx(`th`,{style:{textAlign:`left`,width:`40%`},children:`Object`}),_jsx(`th`,{style:{width:`20%`},children:`Read`}),_jsx(`th`,{style:{width:`20%`},children:`Write`}),_jsx(`th`,{style:{width:`20%`},children:`Subscribe`})]})}),_jsx(`tbody`,{style:{display:`table-row-group`,width:`100%`},children:[...rows].sort((a,b)=>a.label.localeCompare(b.label)).map(row=>_jsxs(`tr`,{id:`row/`+row.label,children:[_jsxs(`td`,{style:{textAlign:`left`},children:[_jsx(_components.a,{href:row.href,children:row.label}),row.display\u0026\u0026_jsx(`div`,{style:{fontSize:`0.9em`,color:`#666`,marginTop:4},children:row.display})]}),_jsx(`td`,{children:renderCellValue(row.read)}),_jsx(`td`,{children:renderCellValue(row.write)}),_jsx(`td`,{children:renderCellValue(row.subscribe)})]},row.label))})]})}),`\n`,_jsxs(_components.p,{children:[`For the complete list of supported Microsoft Graph API `,_jsx(_components.strong,{children:`resources`}),`,\nsee the `,_jsx(_components.a,{href:`https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0`,children:`Microsoft Graph API documentation`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`For the complete list of resources that support `,_jsx(_components.strong,{children:`subscriptions`}),`,\nsee `,_jsx(_components.a,{href:`https://learn.microsoft.com/en-us/graph/api/resources/change-notifications-api-overview?view=graph-rest-1.0`,children:`Microsoft Graph change notifications`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`To determine the exact `,_jsx(_components.strong,{children:`OAuth scope`}),` required for the objects you want to integrate with,\nuse a tool such as the `,_jsx(_components.a,{href:`https://graphpermissions.merill.net/permission/`,children:`Microsoft Graph Permissions Explorer`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`example-integration`,children:`Example Integration`}),`\n`,_jsxs(_components.p,{children:[`For an example manifest file of a Microsoft integration, visit our `,_jsx(_components.a,{href:`https://github.com/amp-labs/samples/blob/main/microsoft/amp.yaml`,children:`samples repo on Github`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-get-started`,children:`Before You Get Started`}),`\n`,_jsxs(_components.p,{children:[`To connect Microsoft services with Ampersand, you will need `,_jsx(_components.a,{href:`https://aka.ms/AppRegistrations/?referrer=https%3A%2F%2Fdev.onedrive.com`,children:`a Microsoft Account`}),`.`]}),`\n`,_jsx(_components.p,{children:`Once your account is created, you’ll need to create an app in the Azure portal, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Client ID`}),`\n`,_jsx(_components.li,{children:`Client Secret`}),`\n`,_jsx(_components.li,{children:`Scopes`}),`\n`]}),`\n`,_jsx(_components.p,{children:`You will then use these credentials to connect your application to Ampersand.`}),`\n`,_jsx(Heading,{level:`3`,id:`create-a-microsoft-account`,children:`Create a Microsoft Account`}),`\n`,_jsx(_components.p,{children:`Here’s how you can sign up for a Microsoft account:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Go to the `,_jsx(_components.a,{href:`https://signup.live.com/signup?sru=https%3a%2f%2flogin.live.com%2foauth20_authorize.srf%3flc%3d1033%26client_id%3d51483342-085c-4d86-bf88-cf50c7252078%26cobrandid%3ded5d1924-9524-4e70-8f68-5ee5e35afbef%26mkt%3dEN-US%26opid%3dE962B0DAAE1D7D3B%26opidt%3d1721584016%26uaid%3d20aa40834b4b4f60a5f6d0caefa69aab%26contextid%3d8123EC532BFC171F%26opignore%3d1\u0026mkt=EN-US\u0026uiflavor=web\u0026lw=1\u0026fl=easi2\u0026cobrandid=ed5d1924-9524-4e70-8f68-5ee5e35afbef\u0026client_id=51483342-085c-4d86-bf88-cf50c7252078\u0026uaid=20aa40834b4b4f60a5f6d0caefa69aab\u0026suc=c44b4083-3bb0-49c1-b47d-974e53cbdf3c\u0026lic=1`,children:`Microsoft Sign up page`}),`.`]}),`\n`,_jsx(_components.li,{children:`Sign up using your preferred method and verify your email.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`creating-a-microsoft-app`,children:`Creating a Microsoft App`}),`\n`,_jsx(_components.p,{children:`Follow the steps below to create a Microsoft app and add the Ampersand redirect URL.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Log in to your `,_jsx(_components.a,{href:`https://portal.azure.com/`,children:`Azure Portal`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Navigate to `,_jsx(_components.strong,{children:`Azure Active Directory`}),` > `,_jsx(_components.strong,{children:`App registrations`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`New registration`}),` button.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Register an application`}),` window, enter the `,_jsx(_components.strong,{children:`Name`}),` and select the `,_jsx(_components.strong,{children:`Supported account types`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Redirect URI`}),` section, select `,_jsx(_components.strong,{children:`Web`}),` and enter the Ampersand redirect URL: `,_jsx(_components.code,{children:`https://api.withampersand.com/callbacks/v1/oauth`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Register`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In the left-hand sidebar, navigate to `,_jsx(_components.strong,{children:`Certificates \u0026 secrets`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`New client secret`}),` and provide a description and expiration period.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Click Add. Note the Client Secret value. You will need it later.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In the left-hand sidebar, navigate to `,_jsx(_components.strong,{children:`Manage >> API permissions`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add a permission`}),` and choose the required scopes. You must include the `,_jsx(_components.strong,{children:`offline_access`}),` scope.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Generate`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/e0b0327-Microsoft1.gif?s=ab255af17eb64c32c1eb9c5ab97562ff`,alt:`Microsoft App Creation`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`670`,height:`670`,\"data-path\":`images/provider-guides/e0b0327-Microsoft1.gif`,\"data-optimize\":`true`,\"data-opv\":`3`}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`add-your-microsoft-app-info-to-ampersand`,children:`Add Your Microsoft App Info to Ampersand`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Log in to your `,_jsx(_components.a,{href:`https://dashboard.withampersand.com`,children:`Ampersand Dashboard`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Select the project where you want to create a Microsoft integration.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?fit=max\u0026auto=format\u0026n=Bx3tggG51e0liOp-\u0026q=85\u0026s=7ebd893fd2a976ebe7cf8af53f8581b8`,alt:`Ampersand Project Selection`,\"data-og-width\":`2244`,width:`2244`,\"data-og-height\":`442`,height:`442`,\"data-path\":`images/provider-guides/31a6a12-Ampersand.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?w=280\u0026fit=max\u0026auto=format\u0026n=Bx3tggG51e0liOp-\u0026q=85\u0026s=90753dcf941d46d12d52390f47b884df 280w, https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?w=560\u0026fit=max\u0026auto=format\u0026n=Bx3tggG51e0liOp-\u0026q=85\u0026s=36525369838d5cf40fd89e4399ba619b 560w, https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?w=840\u0026fit=max\u0026auto=format\u0026n=Bx3tggG51e0liOp-\u0026q=85\u0026s=4bee20c1aa7365f55f99eebf65be862f 840w, https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Bx3tggG51e0liOp-\u0026q=85\u0026s=c8127bcfe60440ec9d856f8c84d31138 1100w, https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Bx3tggG51e0liOp-\u0026q=85\u0026s=529a2c358eeb27165d90e77850c8ea7a 1650w, https://mintcdn.com/ampersand-24eb5c1a/Bx3tggG51e0liOp-/images/provider-guides/31a6a12-Ampersand.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Bx3tggG51e0liOp-\u0026q=85\u0026s=c0d19c356046c6a96d39850bfbccd632 2500w`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Provider Apps`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Microsoft`}),` from the `,_jsx(_components.strong,{children:`Provider`}),` list.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Enter the previously generated Client Secret in the `,_jsx(_components.strong,{children:`Client Secret`}),` field.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`For the `,_jsx(_components.strong,{children:`Client ID`}),` field, go to the Overview page in your Microsoft application, and copy the `,_jsx(_components.strong,{children:`Application ID`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Enter the exact set of scopes that you had previously configured in your Microsoft app.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Save Changes`}),`.`]}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`using-the-connector`,children:`Using the connector`}),`\n`,_jsx(_components.p,{children:`To start integrating with Microsoft:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Create a manifest file like the `,_jsx(_components.a,{href:`https://github.com/amp-labs/samples/blob/main/microsoft/amp.yaml`,children:`example`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Deploy it using the `,_jsx(_components.a,{href:`/cli/overview`,children:`amp CLI`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`If you are using Read Actions, create a `,_jsx(_components.a,{href:`/destinations`,children:`destination`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Embed the `,_jsx(_components.a,{href:`/embeddable-ui-components#install-integration`,children:`InstallIntegration`}),` UI component.`]}),`\n`,_jsxs(_components.li,{children:[`Start using the connector!`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`If your integration has `,_jsx(_components.a,{href:`/read-actions`,children:`Read Actions`}),`, you’ll start getting webhook messages.`]}),`\n`,_jsxs(_components.li,{children:[`If your integration has `,_jsx(_components.a,{href:`/write-actions`,children:`Write Actions`}),`, you can start making API calls to our Write API.`]}),`\n`,_jsxs(_components.li,{children:[`If your integration has `,_jsx(_components.a,{href:`/proxy-actions`,children:`Proxy Actions`}),`, you can start making Proxy API calls.`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsxs(Warning,{children:[`In order to receive a refresh token and be able to access your customers’ Microsoft Graph APIs without reauthenticating, you must include the `,_jsx(_components.code,{children:`offline_access`}),` permission when registering the app with Ampersand`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{rows,Check,Cross,renderCellValue,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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Microsoft","slug":"microsoft","excerpt":"","createdAt":"Sun Jul 21 2024 07:33:01 GMT+0000 (Coordinated Universal Time)","updatedAt":"Wed Jul 31 2024 08:13:04 GMT+0000 (Coordinated Universal Time)","description":null,"href":"/provider-guides/microsoft"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[139,1630,"undefined;const Check=()=>null;const renderCellValue=()=>null;const Cross=()=>_jsx(`span`,{children:`🚫`});function _cre"],[4162,4170,""],[4249,4250,""],[4387,4388,""],[4749,5294,""],[16777,16817,"renderCellValue,Cross,default:MDXContent"]]},"mdxExtracts":{"tableOfContents":[{"title":"What’s Supported","slug":"what’s-supported","depth":2,"children":[{"title":"Supported Actions","slug":"supported-actions","depth":3,"children":[]},{"title":"Supported Objects","slug":"supported-objects","depth":3,"children":[]},{"title":"Example Integration","slug":"example-integration","depth":3,"children":[]}]},{"title":"Before You Get Started","slug":"before-you-get-started","depth":2,"children":[{"title":"Create a Microsoft Account","slug":"create-a-microsoft-account","depth":3,"children":[]},{"title":"Creating a Microsoft App","slug":"creating-a-microsoft-app","depth":3,"children":[]}]},{"title":"Add Your Microsoft App Info to Ampersand","slug":"add-your-microsoft-app-info-to-ampersand","depth":2,"children":[]},{"title":"Using the connector","slug":"using-the-connector","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ampersand-24eb5c1a/918af64092960fd7/troubleshooting.js","/_mintlify/custom/ampersand-24eb5c1a/0bf41ceae2eadd8d/provider-grid.js","/_mintlify/custom/ampersand-24eb5c1a/8d356ec11ed170d1/analytics.js"],"subdomain":"ampersand-24eb5c1a","siteName":"Ampersand","title":"Microsoft - Ampersand","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T19:31:32.614Z","originalFileLocation":"provider-guides/microsoft.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=\"application-name\" content=\"Ampersand\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Microsoft - Ampersand\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ampersand\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ampersand.ai/provider-guides/microsoft\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ampersand-24eb5c1a.mintlify.site/_mintlify/api/og/v2?division=All+providers\u0026amp;title=Microsoft\u0026amp;theme=9c317003eb22ad486143ef26\u0026amp;signature=4339fb2781886faab85faae743c67fa7519da301edec45a5673cebabe6238bcf\">\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=\"Microsoft - Ampersand\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ampersand-24eb5c1a.mintlify.site/_mintlify/api/og/v2?division=All+providers\u0026amp;title=Microsoft\u0026amp;theme=9c317003eb22ad486143ef26\u0026amp;signature=4339fb2781886faab85faae743c67fa7519da301edec45a5673cebabe6238bcf\">\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/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ampersand\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1F71D6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ampersand.ai/provider-guides/microsoft\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/provider-guides/microsoft.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ampersand.ai/#organization\",\"name\":\"Ampersand\",\"url\":\"https://docs.ampersand.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/light.png?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=7799b7c055eff93e5275bfee4335494b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ampersand.ai#website\",\"name\":\"Ampersand\",\"url\":\"https://docs.ampersand.ai\",\"publisher\":{\"@id\":\"https://docs.ampersand.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ampersand.ai/provider-guides/microsoft#webpage\",\"url\":\"https://docs.ampersand.ai/provider-guides/microsoft\",\"name\":\"Microsoft\",\"dateModified\":\"2026-11-13T19:31:32.614Z\",\"isPartOf\":{\"@id\":\"https://docs.ampersand.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ampersand.ai/provider-guides/microsoft#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ampersand.ai/provider-guides/microsoft#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Integrations\",\"item\":\"https://docs.ampersand.ai/provider-guides/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"All providers\",\"item\":\"https://docs.ampersand.ai/provider-guides/accuLynx\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Microsoft\",\"item\":\"https://docs.ampersand.ai/provider-guides/microsoft\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ampersand.ai/provider-guides/microsoft#article\",\"headline\":\"Microsoft\",\"name\":\"Microsoft\",\"url\":\"https://docs.ampersand.ai/provider-guides/microsoft\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ampersand.ai/provider-guides/microsoft#webpage\"},\"dateModified\":\"2026-11-13T19:31:32.614Z\",\"publisher\":{\"@id\":\"https://docs.ampersand.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ampersand.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ampersand\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ampersand\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/provider-guides/microsoft.md","siteName":"Ampersand","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api/overview"}]},{"tab":"Integrations","groups":[{"group":"Integrations","pages":[{"title":"Browse supported provider integrations","sidebarTitle":"Overview","mode":"wide","href":"/provider-guides/overview"},{"group":"All providers","expanded":false,"pages":[{"title":"AccuLynx","href":"/provider-guides/accuLynx"},{"title":"Acuity Scheduling","href":"/provider-guides/acuityScheduling"},{"title":"Aha!","href":"/provider-guides/aha"},{"title":"Aircall","href":"/provider-guides/aircall"},{"title":"Airtable","href":"/provider-guides/airtable"},{"title":"Amplemarket","href":"/provider-guides/amplemarket"},{"title":"Amplitude","href":"/provider-guides/amplitude"},{"title":"Anthropic","href":"/provider-guides/anthropic"},{"title":"Apollo","href":"/provider-guides/apollo"},{"title":"Asana","href":"/provider-guides/asana"},{"title":"Ashby","href":"/provider-guides/ashby"},{"title":"Atlassian","href":"/provider-guides/atlassian"},{"title":"Attio","href":"/provider-guides/attio"},{"title":"Avoma","href":"/provider-guides/avoma"},{"title":"AWeber","href":"/provider-guides/aweber"},{"title":"AWS","href":"/provider-guides/aws"},{"title":"Basecamp","href":"/provider-guides/basecamp"},{"title":"Bentley","href":"/provider-guides/bentley"},{"title":"BigQuery","href":"/provider-guides/bigquery"},{"title":"Bird (MessageBird)","href":"/provider-guides/bird"},{"title":"Bitbucket","href":"/provider-guides/bitbucket"},{"title":"Blackbaud","href":"/provider-guides/blackbaud"},{"title":"Blueshift","href":"/provider-guides/blueshift"},{"title":"Blueshift (EU)","href":"/provider-guides/blueshiftEU"},{"title":"Box","href":"/provider-guides/box"},{"title":"Braintree","href":"/provider-guides/braintree"},{"title":"Braze","href":"/provider-guides/braze"},{"title":"Breakcold","href":"/provider-guides/breakcold"},{"title":"Breezy","href":"/provider-guides/breezy"},{"title":"Brevo","href":"/provider-guides/brevo"},{"title":"Bynder","href":"/provider-guides/bynder"},{"title":"Calendly","href":"/provider-guides/calendly"},{"title":"CallRail","href":"/provider-guides/callRail"},{"title":"Campaign Monitor","href":"/provider-guides/campaignMonitor"},{"title":"Capsule","href":"/provider-guides/capsule"},{"title":"ChargeOver","href":"/provider-guides/chargeOver"},{"title":"Chargebee","href":"/provider-guides/chargebee"},{"title":"ChartMogul","href":"/provider-guides/chartMogul"},{"title":"ChiliPiper","href":"/provider-guides/chilipiper"},{"title":"Chorus","href":"/provider-guides/chorus"},{"title":"Circleback","href":"/provider-guides/circleback"},{"title":"Clari","href":"/provider-guides/clari"},{"title":"Clari Copilot","href":"/provider-guides/clariCopilot"},{"title":"Clarify","href":"/provider-guides/clarify"},{"title":"ClickUp","href":"/provider-guides/clickup"},{"title":"Close","href":"/provider-guides/close"},{"title":"CloudTalk","href":"/provider-guides/cloudtalk"},{"title":"Coda","href":"/provider-guides/coda"},{"title":"ConnectWise","href":"/provider-guides/connectWise"},{"title":"Constant Contact","href":"/provider-guides/constantContact"},{"title":"Copper","href":"/provider-guides/copper"},{"title":"Coupa","href":"/provider-guides/coupa"},{"title":"Crunchbase","href":"/provider-guides/crunchbase"},{"title":"Customer.io Journeys App","href":"/provider-guides/customerJourneysApp"},{"title":"Customer.io Journeys Track","href":"/provider-guides/customerJourneysTrack"},{"title":"Delighted","href":"/provider-guides/delighted"},{"title":"DevRev","href":"/provider-guides/devrev"},{"title":"Discord","href":"/provider-guides/discord"},{"title":"Discourse","href":"/provider-guides/discourse"},{"title":"Dixa","href":"/provider-guides/dixa"},{"title":"Docusign","href":"/provider-guides/docusign"},{"title":"Domo","href":"/provider-guides/domo"},{"title":"Dovetail","href":"/provider-guides/dovetail"},{"title":"Drift","href":"/provider-guides/drift"},{"title":"Dropbox","href":"/provider-guides/dropbox"},{"title":"Dropbox Sign","href":"/provider-guides/dropboxsign"},{"title":"Dynamics 365 Business Central","href":"/provider-guides/dynamicsBusinessCentral"},{"title":"Dynamics 365 CRM","href":"/provider-guides/dynamicsCRM"},{"title":"EmailBison","href":"/provider-guides/emailBison"},{"title":"Fathom","href":"/provider-guides/fathom"},{"title":"Figma","href":"/provider-guides/figma"},{"title":"Fireflies","href":"/provider-guides/fireflies"},{"title":"Flatfile","href":"/provider-guides/flatfile"},{"title":"Formstack","href":"/provider-guides/formstack"},{"title":"Four/Four","href":"/provider-guides/fourFour"},{"title":"Freshchat","href":"/provider-guides/freshchat"},{"title":"Freshdesk","href":"/provider-guides/freshdesk"},{"title":"Front","href":"/provider-guides/front"},{"title":"G2","href":"/provider-guides/g2"},{"title":"Geckoboard","href":"/provider-guides/geckoboard"},{"title":"GetResponse","href":"/provider-guides/getResponse"},{"title":"GitHub","href":"/provider-guides/github"},{"title":"GitLab","href":"/provider-guides/gitlab"},{"title":"GoTo","href":"/provider-guides/goTo"},{"title":"Gong","href":"/provider-guides/gong"},{"title":"Google","href":"/provider-guides/google"},{"title":"Google (workspace delegation)","href":"/provider-guides/google-workspace-delegation"},{"title":"Gorgias","href":"/provider-guides/gorgias"},{"title":"Grain","href":"/provider-guides/grain"},{"title":"Granola","href":"/provider-guides/granola"},{"title":"Groove","href":"/provider-guides/groove"},{"title":"Guru","href":"/provider-guides/guru"},{"title":"Gusto","href":"/provider-guides/gusto"},{"title":"HappyFox","href":"/provider-guides/happyfox"},{"title":"Help Scout Mailbox","href":"/provider-guides/helpScoutMailbox"},{"title":"HeyReach","href":"/provider-guides/heyreach"},{"title":"HighLevel","href":"/provider-guides/highlevel"},{"title":"Hightouch","href":"/provider-guides/hightouch"},{"title":"Hive","href":"/provider-guides/hive"},{"title":"Housecall Pro","href":"/provider-guides/housecallPro"},{"title":"HubSpot","href":"/provider-guides/hubspot"},{"title":"Hunter","href":"/provider-guides/hunter"},{"title":"Insightly","href":"/provider-guides/insightly"},{"title":"Instantly","href":"/provider-guides/instantly"},{"title":"Intercom","href":"/provider-guides/intercom"},{"title":"Ironclad","href":"/provider-guides/ironclad"},{"title":"Iterable","href":"/provider-guides/iterable"},{"title":"Jira","href":"/provider-guides/jira"},{"title":"Jobber","href":"/provider-guides/jobber"},{"title":"Join.me","href":"/provider-guides/joinMe"},{"title":"Jotform","href":"/provider-guides/jotform"},{"title":"Jump","href":"/provider-guides/jump"},{"title":"JustCall","href":"/provider-guides/justCall"},{"title":"Kaseya VSAX","href":"/provider-guides/kaseyaVSAX"},{"title":"Keap","href":"/provider-guides/keap"},{"title":"Kit","href":"/provider-guides/kit"},{"title":"Klaviyo","href":"/provider-guides/klaviyo"},{"title":"Lemlist","href":"/provider-guides/lemlist"},{"title":"Lever","href":"/provider-guides/lever"},{"title":"Lightfield","href":"/provider-guides/lightfield"},{"title":"Linear","href":"/provider-guides/linear"},{"title":"LinkedIn","href":"/provider-guides/linkedin"},{"title":"Livestorm","href":"/provider-guides/livestorm"},{"title":"Lob","href":"/provider-guides/lob"},{"title":"Loxo","href":"/provider-guides/loxo"},{"title":"Mailgun","href":"/provider-guides/mailgun"},{"title":"Marketo","href":"/provider-guides/marketo"},{"title":"Meta","description":null,"href":"/provider-guides/meta"},{"title":"Microsoft","href":"/provider-guides/microsoft"},{"title":"Microsoft (Admin consent)","description":null,"href":"/provider-guides/microsoftAdminConsent"},{"title":"Miro","href":"/provider-guides/miro"},{"title":"Mixmax","href":"/provider-guides/mixmax"},{"title":"Mixpanel","href":"/provider-guides/mixpanel"},{"title":"Monaco","href":"/provider-guides/monaco"},{"title":"Monday","href":"/provider-guides/monday"},{"title":"Mural","href":"/provider-guides/mural"},{"title":"NetSuite","href":"/provider-guides/netsuite"},{"title":"NetSuite (M2M)","href":"/provider-guides/netsuite-m2m"},{"title":"Notion","href":"/provider-guides/notion"},{"title":"Nutshell","href":"/provider-guides/nutshell"},{"title":"Odoo","href":"/provider-guides/odoo"},{"title":"Okta","href":"/provider-guides/okta"},{"title":"OpenAI","href":"/provider-guides/openAI"},{"title":"Orb","href":"/provider-guides/orb"},{"title":"Outplay","href":"/provider-guides/outplay"},{"title":"Outreach","href":"/provider-guides/outreach"},{"title":"Paddle","href":"/provider-guides/paddle"},{"title":"Paddle Sandbox","href":"/provider-guides/paddleSandbox"},{"title":"PhoneBurner","href":"/provider-guides/phoneBurner"},{"title":"Pinterest","href":"/provider-guides/pinterest"},{"title":"Pipedrive","href":"/provider-guides/pipedrive"},{"title":"Pipeliner","href":"/provider-guides/pipeliner"},{"title":"Podium","href":"/provider-guides/podium"},{"title":"Productboard","href":"/provider-guides/productBoard"},{"title":"Procore","href":"/provider-guides/procore"},{"title":"Pylon","href":"/provider-guides/pylon"},{"title":"QuickBooks","href":"/provider-guides/quickbooks"},{"title":"Ramp","href":"/provider-guides/ramp"},{"title":"Rebilly","href":"/provider-guides/rebilly"},{"title":"Recurly","href":"/provider-guides/recurly"},{"title":"Reply","href":"/provider-guides/reply"},{"title":"RevenueCat","href":"/provider-guides/revenuecat"},{"title":"RingCentral","href":"/provider-guides/ringCentral"},{"title":"Sage Intacct","href":"/provider-guides/sageIntacct"},{"title":"Salesfinity","href":"/provider-guides/salesfinity"},{"title":"Salesflare","href":"/provider-guides/salesflare"},{"title":"Salesforce","href":"/provider-guides/salesforce"},{"title":"Salesforce (JWT authentication)","href":"/provider-guides/salesforce-jwt"},{"title":"Salesloft","href":"/provider-guides/salesloft"},{"title":"Segment","href":"/provider-guides/segment"},{"title":"Seismic","href":"/provider-guides/seismic"},{"title":"Sellsy","href":"/provider-guides/sellsy"},{"title":"SendGrid","href":"/provider-guides/sendGrid"},{"title":"ServiceNow","href":"/provider-guides/serviceNow"},{"title":"Shopify","href":"/provider-guides/shopify"},{"title":"Slack","href":"/provider-guides/slack"},{"title":"Smartlead","href":"/provider-guides/smartlead"},{"title":"Smartsheet","href":"/provider-guides/smartsheet"},{"title":"Snapchat Ads","href":"/provider-guides/snapchatAds"},{"title":"Snowflake","href":"/provider-guides/snowflake"},{"title":"SolarWinds Service Desk","href":"/provider-guides/solarwindsServiceDesk"},{"title":"Square","href":"/provider-guides/square"},{"title":"Stripe","href":"/provider-guides/stripe"},{"title":"SuperSend","href":"/provider-guides/superSend"},{"title":"SurveyMonkey","href":"/provider-guides/surveyMonkey"},{"title":"Talkdesk","href":"/provider-guides/talkdesk"},{"title":"Teamleader","href":"/provider-guides/teamleader"},{"title":"Teamwork","href":"/provider-guides/teamwork"},{"title":"Timely","href":"/provider-guides/timely"},{"title":"Tipalti","href":"/provider-guides/tipalti"},{"title":"Vtiger","href":"/provider-guides/vtiger"},{"title":"Wealthbox","href":"/provider-guides/wealthbox"},{"title":"Webex","href":"/provider-guides/webex"},{"title":"Webflow","href":"/provider-guides/webflow"},{"title":"Whereby","href":"/provider-guides/whereby"},{"title":"WordPress","href":"/provider-guides/wordpress"},{"title":"Wrike","href":"/provider-guides/wrike"},{"title":"Workday","href":"/provider-guides/workday"},{"title":"Xero","href":"/provider-guides/xero"},{"title":"Zendesk Support","href":"/provider-guides/zendeskSupport"},{"title":"Zoho","href":"/provider-guides/zoho"},{"title":"Zoom","href":"/provider-guides/zoom"},{"title":"ZoomInfo","href":"/provider-guides/zoominfo"}]},{"group":"Customer guides","expanded":false,"pages":[{"title":"Ampersand customer guides for integration setup","sidebarTitle":"Overview","href":"/customer-guides/overview"},{"title":"BigQuery","href":"/customer-guides/bigquery"},{"title":"Google (workspace delegation)","href":"/customer-guides/google-workspace-delegation"},{"title":"Housecall Pro","href":"/customer-guides/housecallPro"},{"title":"HubSpot","href":"/customer-guides/hubspot"},{"title":"Loxo","href":"/customer-guides/loxo"},{"title":"Marketo","href":"/customer-guides/marketo"},{"title":"NetSuite","href":"/customer-guides/netsuite"},{"title":"Salesforce","href":"/customer-guides/salesforce"},{"title":"Salesforce (JWT authentication)","href":"/customer-guides/salesforce-jwt"},{"title":"Snowflake","href":"/customer-guides/snowflake"},{"title":"Update a connection","href":"/customer-guides/update-connection"},{"title":"Zoho","href":"/customer-guides/zoho"}]}]}]},{"tab":"Troubleshooting","pages":[{"title":"Troubleshooting","href":"/troubleshooting-guides/overview"}]}]},"basePath":"","title":"Microsoft - Ampersand","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-CkI5al_8.js","lightbox-handle-r17bVUz3.js"]}