Connect Gmail, Slack, or any API and give your agent one safe capability.
Tools let an agent do useful work outside the chat. Start with one read capability before adding write actions.
Use a built-in integration
Open Integrations, choose a provider, and connect its credentials. Bothive keeps secrets in the integration connection; do not paste tokens into prompts or HiveLang.
Connect a custom API
Choose Connect your API and provide a name, base URL, authentication method, and endpoint. You can import OpenAPI JSON or YAML, paste a docs URL, or describe the endpoint manually.
Every configured endpoint must pass a live test before the integration can be connected. Use safe test credentials and test data.
Give the agent the capability
Return to the builder and select the connected capability. Describe when it should be used, what inputs it needs, and what should happen if the request fails.
Add an approval gate
Reading data is usually low risk. Sending, publishing, deleting, charging, or inviting should wait for explicit approval. Test the approval card in Autopilot before enabling production traffic.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bothive","colors":{"primary":"#09090b","light":"#f4f4f5","dark":"#09090b"},"logo":{"light":"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-light.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=0030856b13a878aa5fa511ba61258250","dark":"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-dark.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=352ede20b4e6122c17cabf0370d70b6b","href":"https://docs.bothive.cloud"},"favicon":"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-dark.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=352ede20b4e6122c17cabf0370d70b6b","api":{"playground":{}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://docs.bothive.cloud/guides/first-agent","label":"Guides"},{"href":"https://docs.bothive.cloud/api/overview","label":"API reference"},{"href":"https://docs.bothive.cloud/?assistant","label":"Ask AI"},{"href":"https://bothive.cloud/dashboard","label":"Open Bothive"}]},"search":{"prompt":"Search documentation..."},"seo":{"metatags":{"canonical":"https://docs.bothive.cloud","og:image":"https://docs.bothive.cloud/images/docs-og-image.png","og:image:width":"1734","og:image:height":"907","og:image:alt":"Bothive Documentation - Build agents that ship","twitter:card":"summary_large_image","twitter:image":"https://docs.bothive.cloud/images/docs-og-image.png"}},"contextual":{"options":["assistant","copy"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bothive","hasAudioNarration":false,"actualSubdomain":"bothive","customDomains":["docs.bothive.cloud"],"gitSource":{"type":"github","owner":"ciphrnotfound","repo":"laughing-potato","deployBranch":"main","contentDirectory":"bothive/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae95abbb9c52538cea7f7b2:success","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Core Concepts","count":9},{"language":"default","tag":"Building Agents","count":9},{"language":"default","tag":"Start Here","count":5},{"language":"default","tag":"API Reference","count":4},{"language":"default","tag":"Deployment \u0026 Operations","count":4},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Resources","count":2},{"language":"default","tag":"Integrations","count":2},{"language":"default","tag":"Teams \u0026 Organisations","count":2}]},"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":"custom.css","content":"/* vietnamese */\n@font-face {\n font-family: 'Bricolage Grotesque';\n font-style: normal;\n font-weight: 300 700;\n font-stretch: 75% 100%;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/bricolagegrotesque/v9/3y996as8bTXq_nANBjzKo3IeZx8z6up5L-eNGe6N.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Bricolage Grotesque';\n font-style: normal;\n font-weight: 300 700;\n font-stretch: 75% 100%;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/bricolagegrotesque/v9/3y996as8bTXq_nANBjzKo3IeZx8z6up5L-aNGe6N.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Bricolage Grotesque';\n font-style: normal;\n font-weight: 300 700;\n font-stretch: 75% 100%;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/bricolagegrotesque/v9/3y996as8bTXq_nANBjzKo3IeZx8z6up5L-iNGQ.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--bv-bg: #fcfbf9;--bv-panel: #ffffff;--bv-panel-hover: #f4f4f5;--bv-border: rgba(0, 0, 0, 0.07);--bv-border-strong: rgba(0, 0, 0, 0.13);--bv-text: #09090b;--bv-muted: #52525b;--bv-faint: #a1a1aa;--bv-accent: #09090b;--bv-accent-hover: #18181b;--bv-card: #000000;--bv-card-text: #fafafa;--bv-card-muted: #a1a1aa;--bv-code-bg: #f7f7f6;--bv-code-bar: #efefed;--bv-code-text: #27272a;--bv-code-border: rgba(0, 0, 0, 0.1);--font-bv: \"Bricolage Grotesque\", ui-sans-serif, system-ui, sans-serif}.dark,[data-theme=\"dark\"]{--bv-bg: #0c0c0e;--bv-panel: #131316;--bv-panel-hover: rgba(255, 255, 255, 0.05);--bv-border: rgba(255, 255, 255, 0.08);--bv-border-strong: rgba(255, 255, 255, 0.14);--bv-text: #f4f4f5;--bv-muted: #a1a1aa;--bv-faint: #52525b;--bv-accent: #f4f4f5;--bv-accent-hover: #ffffff;--bv-code-bg: #080808;--bv-code-bar: #0e0e10;--bv-code-text: #e4e4e7;--bv-code-border: rgba(255, 255, 255, 0.11)}html,body{background:var(--bv-bg)!important;color:var(--bv-text)!important;font-family:var(--font-bv)!important;font-size:14px!important;-webkit-font-smoothing:antialiased;letter-spacing:0!important;box-shadow:none!important}body *{font-family:var(--font-bv)!important;letter-spacing:0!important;box-shadow:none!important}h1,h2,h3,h4,h5,h6{color:var(--bv-text)!important;font-weight:600!important;letter-spacing:-0.01em!important}h1{font-size:clamp(1.5rem, 2.5vw, 2rem)!important;line-height:1.15!important}h2{margin-top:2.5rem!important;border-top:1px solid var(--bv-border)!important;padding-top:1.25rem!important;font-size:1.05rem!important}h3{font-size:0.9rem!important;font-weight:600!important}.hero-container{background:transparent!important;border:1px solid var(--bv-border)!important;border-radius:10px!important;padding:36px 28px!important;margin-bottom:32px!important;text-align:left!important;transition:all 0.2s ease!important}.hero-title{font-family:var(--font-bv)!important;font-weight:400!important;font-size:clamp(1.75rem, 3vw, 2.35rem)!important;color:var(--bv-text)!important;letter-spacing:-0.02em!important;margin-bottom:16px!important}.hero-subtitle{font-size:0.95rem!important;color:var(--bv-muted)!important;max-width:640px!important;margin:0!important;line-height:1.55!important}p,li,td{color:var(--bv-muted)!important;line-height:1.75!important}strong,th{color:var(--bv-text)!important;font-weight:500!important}a{color:var(--bv-text)!important;text-decoration-color:var(--bv-border-strong)!important;text-underline-offset:4px!important}a:hover{color:var(--bv-accent-hover)!important;text-decoration-color:var(--bv-border-strong)!important}header,[class*=\"topbar\"],[class*=\"Topbar\"]{background:var(--bv-bg)!important;border-bottom:1px solid var(--bv-border)!important;backdrop-filter:blur(12px)!important}[class*=\"topbar\"] a[href*=\"signup\"],[class*=\"Topbar\"] a[href*=\"signup\"],[class*=\"topbar\"] a[href*=\"dashboard\"],[class*=\"Topbar\"] a[href*=\"dashboard\"],[class*=\"topbar\"] button,[class*=\"Topbar\"] button{border:1px solid var(--bv-border-strong)!important;background:transparent!important;color:var(--bv-text)!important;font-weight:500!important;border-radius:8px!important;padding:0.35rem 0.85rem!important;font-size:0.85rem!important;transition:all 0.15s ease!important;box-shadow:inset 0 0 0 1px var(--bv-border)!important}[class*=\"topbar\"] a[href*=\"signup\"]:hover,[class*=\"Topbar\"] a[href*=\"signup\"]:hover,[class*=\"topbar\"] a[href*=\"dashboard\"]:hover,[class*=\"Topbar\"] a[href*=\"dashboard\"]:hover,[class*=\"topbar\"] button:hover,[class*=\"Topbar\"] button:hover{background:var(--bv-panel-hover)!important;border-color:var(--bv-border-strong)!important}header a[href*=\"bothive.cloud/dashboard\"],nav a[href*=\"bothive.cloud/dashboard\"],[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"],[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"],a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]{display:inline-flex!important;align-items:center!important;justify-content:center!important;height:2.25rem!important;min-height:2.25rem!important;border:1px solid rgba(0, 0, 0, 0.12)!important;border-radius:0.5rem!important;background:transparent!important;color:#171717!important;padding:0 1rem!important;font-size:13px!important;font-weight:500!important;line-height:1!important;letter-spacing:0!important;text-decoration:none!important;box-shadow:none!important;opacity:1!important;background-image:none!important;transition:background-color 200ms ease, border-color 200ms ease, color 200ms ease, transform 200ms ease!important}html.dark header a[href*=\"bothive.cloud/dashboard\"],html.dark nav a[href*=\"bothive.cloud/dashboard\"],html[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"],html[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"],[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"],[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"],html.dark a[role=\"button\"][href*=\"bothive.cloud/dashboard\"],html[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"],[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]{border-color:rgba(255, 255, 255, 0.12)!important;background:transparent!important;color:#f4f4f5!important;box-shadow:none!important}header a[href*=\"bothive.cloud/dashboard\"] *,nav a[href*=\"bothive.cloud/dashboard\"] *,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"] *,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"] *,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"] *{color:inherit!important;fill:currentColor!important}header a[href*=\"bothive.cloud/dashboard\"]:hover,nav a[href*=\"bothive.cloud/dashboard\"]:hover,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"]:hover,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"]:hover,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover{border-color:rgba(0, 0, 0, 0.18)!important;background:#f7f7f6!important;color:#09090b!important;text-decoration:none!important}html.dark header a[href*=\"bothive.cloud/dashboard\"]:hover,html.dark nav a[href*=\"bothive.cloud/dashboard\"]:hover,html[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"]:hover,html[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"]:hover,[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"]:hover,[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"]:hover,html.dark a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover,html[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover,[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover{border-color:rgba(255, 255, 255, 0.15)!important;background:rgba(255, 255, 255, 0.02)!important;color:#fff!important}header a[href*=\"bothive.cloud/dashboard\"]:active,nav a[href*=\"bothive.cloud/dashboard\"]:active,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"]:active,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"]:active,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:active{transform:scale(0.98)!important}header a[href*=\"bothive.cloud/dashboard\"]:focus-visible,nav a[href*=\"bothive.cloud/dashboard\"]:focus-visible,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"]:focus-visible,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"]:focus-visible,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:focus-visible{outline:2px solid var(--bv-text)!important;outline-offset:2px!important}[class*=\"sidebar\"],[class*=\"Sidebar\"],aside:first-of-type{background:var(--bv-bg)!important;border-right:1px solid var(--bv-border)!important}[class*=\"sidebar\"] a,[class*=\"Sidebar\"] a{font-size:12px!important;color:var(--bv-muted)!important;border-radius:7px!important;transition:all 0.12s ease!important}[class*=\"sidebar\"] a:hover,[class*=\"Sidebar\"] a:hover{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important}[class*=\"sidebar\"] a[class*=\"active\"],[class*=\"Sidebar\"] a[class*=\"active\"]{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important;font-weight:500!important}[class*=\"search\"] input,[class*=\"Search\"] input,button[aria-label*=\"Search\"]{border:1px solid var(--bv-border)!important;border-radius:8px!important;background:transparent!important}main{max-width:78rem!important}article{max-width:48rem!important}@media (max-width: 768px){.hero-container{padding:28px 20px!important;margin-bottom:24px!important}th,td{padding:0.7rem 0.8rem!important}}[class*=\"TableOfContents\"],[class*=\"toc-container\"],[class*=\"OnThisPage\"],[class*=\"on-this-page\"]{background:transparent!important;border:none!important;padding-top:1.5rem!important}[class*=\"TableOfContents\"]>p,[class*=\"TableOfContents\"]>span,[class*=\"toc\"]>p,[class*=\"OnThisPage\"]>p{font-size:10px!important;font-weight:500!important;text-transform:uppercase!important;letter-spacing:0.12em!important;color:var(--bv-faint)!important;margin-bottom:0.75rem!important}[class*=\"TableOfContents\"] ul,[class*=\"TableOfContents\"] ol,[class*=\"toc\"] ul{border-left:1px solid var(--bv-border)!important;padding-left:0!important;margin-left:0!important;list-style:none!important}[class*=\"TableOfContents\"] a,[class*=\"toc\"] a,[class*=\"OnThisPage\"] a{display:block!important;font-size:11px!important;font-weight:400!important;color:var(--bv-faint)!important;border-left:1.5px solid transparent!important;margin-left:-1px!important;padding:0.22rem 0 0.22rem 0.875rem!important;transition:color 0.12s ease, border-color 0.12s ease!important;text-decoration:none!important;line-height:1.5!important}[class*=\"TableOfContents\"] a:hover,[class*=\"toc\"] a:hover,[class*=\"OnThisPage\"] a:hover{color:var(--bv-text)!important;text-decoration:none!important}[class*=\"TableOfContents\"] a[class*=\"active\"],[class*=\"TableOfContents\"] a[aria-current],[class*=\"toc\"] a[class*=\"active\"],[class*=\"OnThisPage\"] a[class*=\"active\"]{color:var(--bv-text)!important;border-left-color:var(--bv-text)!important;font-weight:500!important}[class*=\"feedback\"],[class*=\"Feedback\"],[class*=\"rating\"],[class*=\"Rating\"]{display:inline-flex!important;align-items:center!important;gap:0.15rem!important;border:1px solid var(--bv-border)!important;border-radius:8px!important;background:transparent!important;padding:0.2rem!important;margin-bottom:2.5rem!important}[class*=\"feedback\"] button,[class*=\"Feedback\"] button,[class*=\"rating\"] button,[class*=\"Rating\"] button{border:none!important;border-radius:6px!important;background:transparent!important;color:var(--bv-faint)!important;padding:0.3rem 0.5rem!important;font-size:11px!important;font-weight:400!important;transition:all 0.12s ease!important;cursor:pointer!important}[class*=\"feedback\"] button:hover,[class*=\"Feedback\"] button:hover,[class*=\"rating\"] button:hover,[class*=\"Rating\"] button:hover{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important}[class*=\"feedback\"] button[class*=\"active\"],[class*=\"feedback\"] button[aria-pressed=\"true\"],[class*=\"Feedback\"] button[class*=\"active\"],[class*=\"rating\"] button[class*=\"active\"],[class*=\"rating\"] button[aria-pressed=\"true\"]{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important;font-weight:500!important}.card,[class*=\"Card\"]:not([class*=\"CardGroup\"]),.glass-effect{position:relative!important;overflow:hidden!important;border:1px solid var(--bv-border)!important;border-radius:10px!important;background:var(--bv-panel)!important;color:var(--bv-muted)!important;padding:1.1rem 1.15rem!important;transition:border-color 160ms ease, transform 160ms ease!important}.card:hover,[class*=\"Card\"]:not([class*=\"CardGroup\"]):hover,.glass-effect:hover{border-color:var(--bv-border-strong)!important;background:var(--bv-panel-hover)!important;transform:translateY(-1px)!important}[class*=\"CardGroup\"],[class*=\"card-group\"]{gap:0.75rem!important;margin:1.25rem 0 1.75rem!important}[class*=\"Card\"]:not([class*=\"CardGroup\"])>:first-child,.card>:first-child{margin-top:0!important}.card svg,[class*=\"Card\"] svg,.glass-effect svg,[class*=\"card-icon\"],[class*=\"CardIcon\"]{color:var(--bv-text)!important;opacity:0.78!important}[class*=\"card-icon\"],[class*=\"CardIcon\"]{width:1.75rem!important;height:1.75rem!important;border:1px solid var(--bv-border)!important;border-radius:7px!important;background:var(--bv-bg)!important;padding:0.38rem!important;margin-bottom:0.8rem!important}.card strong,[class*=\"Card\"] strong,[class*=\"card-title\"],.glass-effect strong{color:var(--bv-text)!important;font-weight:500!important;font-size:0.88rem!important;line-height:1.4!important}.card p,[class*=\"Card\"] p,.glass-effect p{color:var(--bv-muted)!important;margin-top:0.4rem!important;margin-bottom:0!important;font-size:0.78rem!important;line-height:1.6!important}[class*=\"Card\"] a,.card a,.glass-effect a{color:var(--bv-text)!important;text-decoration:none!important}[class*=\"callout\"],[class*=\"Callout\"]{border:1px solid var(--bv-border-strong)!important;border-radius:9px!important;background:var(--bv-panel)!important;padding:0.9rem 1rem!important}button,[role=\"button\"]:not(a[href*=\"bothive.cloud/dashboard\"]),.btn-primary:not(a[href*=\"bothive.cloud/dashboard\"]),.btn-secondary:not(a[href*=\"bothive.cloud/dashboard\"]){border-radius:8px!important;border:1px solid var(--bv-border-strong)!important;background:transparent!important;color:var(--bv-text)!important;font-weight:500!important;transition:all 0.12s ease!important}button:hover,[role=\"button\"]:not(a[href*=\"bothive.cloud/dashboard\"]):hover{background:var(--bv-panel-hover)!important}:not(pre)>code{font-family:\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace!important;border:1px solid var(--bv-border)!important;border-radius:5px!important;background:var(--bv-panel)!important;color:var(--bv-text)!important;font-size:0.82em!important;font-weight:400!important;padding:0.12rem 0.32rem!important}pre{margin:1.25rem 0 1.65rem!important;border:1px solid var(--bv-code-border)!important;border-radius:10px!important;background:var(--bv-code-bg)!important;padding:1.05rem 1.15rem!important;overflow:auto!important;scrollbar-color:var(--bv-border-strong) transparent!important}pre code{font-family:\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace!important;border:0!important;background:transparent!important;padding:0!important;color:var(--bv-code-text)!important;font-size:0.76rem!important;line-height:1.75!important;tab-size:2!important;font-variant-ligatures:none!important}[class*=\"CodeBlock\"],[class*=\"code-block\"],[class*=\"CodeGroup\"],[class*=\"code-group\"]{overflow:hidden!important;border:1px solid var(--bv-code-border)!important;border-radius:10px!important;background:var(--bv-code-bg)!important;margin:1.25rem 0 1.65rem!important}[class*=\"CodeBlock\"] pre,[class*=\"code-block\"] pre,[class*=\"CodeGroup\"] pre,[class*=\"code-group\"] pre{margin:0!important;border:0!important;border-radius:0!important}[class*=\"CodeBlock\"] button,[class*=\"code-block\"] button,[class*=\"CodeGroup\"] button,[class*=\"code-group\"] button{border:0!important;background:transparent!important;color:var(--bv-faint)!important;font-family:\"JetBrains Mono\", ui-monospace, monospace!important;font-size:0.68rem!important;font-weight:400!important}[class*=\"CodeBlock\"] button:hover,[class*=\"code-block\"] button:hover,[class*=\"CodeGroup\"] button:hover,[class*=\"code-group\"] button:hover,[class*=\"CodeBlock\"] button[aria-selected=\"true\"],[class*=\"code-block\"] button[aria-selected=\"true\"],[class*=\"CodeGroup\"] button[aria-selected=\"true\"],[class*=\"code-group\"] button[aria-selected=\"true\"]{color:var(--bv-code-text)!important;background:var(--bv-code-bar)!important}[class*=\"CodeBlock\"]>div:first-child,[class*=\"code-block\"]>div:first-child,[class*=\"CodeGroup\"]>div:first-child,[class*=\"code-group\"]>div:first-child{min-height:2.45rem!important;border-bottom:1px solid var(--bv-code-border)!important;background:var(--bv-code-bar)!important}pre code span[style*=\"--shiki-light\"]{color:var(--shiki-light)!important}.dark pre code span[style*=\"--shiki-dark\"],[data-theme=\"dark\"] pre code span[style*=\"--shiki-dark\"]{color:var(--shiki-dark)!important}pre .token.comment,pre .token.prolog,pre .token.doctype{color:#7c7c85!important}pre .token.keyword,pre .token.selector,pre .token.atrule{color:#b35c9b!important}pre .token.string,pre .token.attr-value,pre .token.inserted{color:#41856a!important}pre .token.function,pre .token.class-name{color:#8a641f!important}pre .token.number,pre .token.boolean,pre .token.constant{color:#3976a8!important}.dark pre .token.keyword,[data-theme=\"dark\"] pre .token.keyword,.dark pre .token.selector,[data-theme=\"dark\"] pre .token.selector,.dark pre .token.atrule,[data-theme=\"dark\"] pre .token.atrule{color:#d78fc7!important}.dark pre .token.string,[data-theme=\"dark\"] pre .token.string,.dark pre .token.attr-value,[data-theme=\"dark\"] pre .token.attr-value,.dark pre .token.inserted,[data-theme=\"dark\"] pre .token.inserted{color:#83c6a5!important}.dark pre .token.function,[data-theme=\"dark\"] pre .token.function,.dark pre .token.class-name,[data-theme=\"dark\"] pre .token.class-name{color:#e2bb72!important}.dark pre .token.number,[data-theme=\"dark\"] pre .token.number,.dark pre .token.boolean,[data-theme=\"dark\"] pre .token.boolean,.dark pre .token.constant,[data-theme=\"dark\"] pre .token.constant{color:#78aee0!important}@media (max-width: 640px){.card,[class*=\"Card\"]:not([class*=\"CardGroup\"]),.glass-effect{padding:0.95rem!important}pre{border-radius:8px!important;padding:0.9rem!important}pre code{font-size:0.72rem!important}}table{border:1px solid var(--bv-border)!important;border-radius:10px!important;overflow:hidden!important;background:var(--bv-bg)!important;border-collapse:collapse!important;width:100%!important}th,td{border:1px solid var(--bv-border)!important;padding:0.875rem 1.25rem!important;text-align:left!important}th{background:var(--bv-panel)!important;color:var(--bv-text)!important;font-weight:500!important;font-size:0.85rem!important;letter-spacing:0.02em!important}td{font-size:0.9rem!important}::-webkit-scrollbar{width:5px;height:5px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{border-radius:999px;background:var(--bv-border-strong)}::selection{background:var(--bv-text)!important;color:var(--bv-bg)!important}a[href*=\"bothive.cloud/dashboard\"],:is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]){appearance:none!important;-webkit-appearance:none!important;background-clip:padding-box!important;background:transparent!important;background-color:transparent!important;background-image:none!important;border:1px solid rgba(9, 9, 11, 0.14)!important;border-radius:0.5rem!important;box-shadow:none!important;color:#09090b!important;display:inline-flex!important;align-items:center!important;justify-content:center!important;font-size:13px!important;font-weight:500!important;height:2.25rem!important;line-height:1!important;padding:0 1rem!important;text-decoration:none!important;text-shadow:none!important}a[href*=\"bothive.cloud/dashboard\"]:hover,:is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]):hover{background:#f4f4f5!important;background-color:#f4f4f5!important;border-color:rgba(9, 9, 11, 0.22)!important;color:#09090b!important}:is(.dark,[data-theme=\"dark\"]) a[href*=\"bothive.cloud/dashboard\"],:is(.dark,[data-theme=\"dark\"]) :is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]){background:transparent!important;background-color:transparent!important;border-color:rgba(255, 255, 255, 0.14)!important;color:#f4f4f5!important}:is(.dark,[data-theme=\"dark\"]) a[href*=\"bothive.cloud/dashboard\"]:hover,:is(.dark,[data-theme=\"dark\"]) :is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]):hover{background:rgba(255, 255, 255, 0.04)!important;background-color:rgba(255, 255, 255, 0.04)!important;border-color:rgba(255, 255, 255, 0.22)!important;color:#ffffff!important}a[href*=\"?assistant\"]{color:var(--bv-muted)!important;font-size:13px!important;font-weight:500!important;text-decoration:none!important}a[href*=\"?assistant\"]:hover{color:var(--bv-text)!important;text-decoration:none!important}"}]}
{"page":{"pagePath":"guides/connect-first-tool","slug":"/guides/connect-first-tool","pageMetadata":{"title":"Connect Your First Tool","description":"Connect Gmail, Slack, or any API and give your agent one safe capability.","href":"/guides/connect-first-tool"},"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: \"Connect Gmail, Slack, or any API and give your agent one safe capability.\"\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{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Tools let an agent do useful work outside the chat. Start with one read capability before adding write actions.`}),`\n`,_jsx(Heading,{level:`2`,id:`use-a-built-in-integration`,children:`Use a built-in integration`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Integrations`}),`, choose a provider, and connect its credentials. Bothive keeps secrets in the integration connection; do not paste tokens into prompts or HiveLang.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-a-custom-api`,children:`Connect a custom API`}),`\n`,_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`Connect your API`}),` and provide a name, base URL, authentication method, and endpoint. You can import OpenAPI JSON or YAML, paste a docs URL, or describe the endpoint manually.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Every configured endpoint must pass a live test before the integration can be connected. Use safe test credentials and test data.`})}),`\n`,_jsx(Heading,{level:`2`,id:`give-the-agent-the-capability`,children:`Give the agent the capability`}),`\n`,_jsx(_components.p,{children:`Return to the builder and select the connected capability. Describe when it should be used, what inputs it needs, and what should happen if the request fails.`}),`\n`,_jsx(Heading,{level:`2`,id:`add-an-approval-gate`,children:`Add an approval gate`}),`\n`,_jsx(_components.p,{children:`Reading data is usually low risk. Sending, publishing, deleting, charging, or inviting should wait for explicit approval. Test the approval card in Autopilot before enabling production traffic.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{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":"Connect Your First Tool","description":"Connect Gmail, Slack, or any API and give your agent one safe capability.","href":"/guides/connect-first-tool"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Use a built-in integration","slug":"use-a-built-in-integration","depth":2,"children":[]},{"title":"Connect a custom API","slug":"connect-a-custom-api","depth":2,"children":[]},{"title":"Give the agent the capability","slug":"give-the-agent-the-capability","depth":2,"children":[]},{"title":"Add an approval gate","slug":"add-an-approval-gate","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/bothive/9bef8a0731a3e181/bothive-docs-assistant.js"],"subdomain":"bothive","siteName":"Bothive","title":"Connect Your First Tool - Bothive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-25T13:53:35.489Z","originalFileLocation":"guides/connect-first-tool.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=\"Connect Gmail, Slack, or any API and give your agent one safe capability.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bothive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Your First Tool - Bothive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Gmail, Slack, or any API and give your agent one safe capability.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bothive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bothive.cloud/guides/connect-first-tool\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.bothive.cloud/images/docs-og-image.png\">\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=\"Connect Your First Tool - Bothive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Gmail, Slack, or any API and give your agent one safe capability.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.bothive.cloud/images/docs-og-image.png\">\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/bothive/zpYsQvaK61VW1Uyi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bothive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#09090b\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Bothive Documentation - Build agents that ship\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bothive.cloud/guides/connect-first-tool\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/connect-first-tool.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bothive.cloud/#organization\",\"name\":\"Bothive\",\"url\":\"https://docs.bothive.cloud\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-light.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=0030856b13a878aa5fa511ba61258250\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bothive.cloud#website\",\"name\":\"Bothive\",\"url\":\"https://docs.bothive.cloud\",\"publisher\":{\"@id\":\"https://docs.bothive.cloud/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bothive.cloud/guides/connect-first-tool#webpage\",\"url\":\"https://docs.bothive.cloud/guides/connect-first-tool\",\"name\":\"Connect Your First Tool\",\"description\":\"Connect Gmail, Slack, or any API and give your agent one safe capability.\",\"dateModified\":\"2026-07-25T13:53:35.489Z\",\"isPartOf\":{\"@id\":\"https://docs.bothive.cloud#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bothive.cloud/guides/connect-first-tool#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bothive.cloud/guides/connect-first-tool#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start Here\",\"item\":\"https://docs.bothive.cloud/guides/first-agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect Your First Tool\",\"item\":\"https://docs.bothive.cloud/guides/connect-first-tool\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bothive.cloud/guides/connect-first-tool#article\",\"headline\":\"Connect Your First Tool\",\"name\":\"Connect Your First Tool\",\"description\":\"Connect Gmail, Slack, or any API and give your agent one safe capability.\",\"url\":\"https://docs.bothive.cloud/guides/connect-first-tool\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bothive.cloud/guides/connect-first-tool#webpage\"},\"image\":\"https://docs.bothive.cloud/images/docs-og-image.png\",\"dateModified\":\"2026-07-25T13:53:35.489Z\",\"publisher\":{\"@id\":\"https://docs.bothive.cloud/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bothive.cloud#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bothive\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bothive\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/connect-first-tool.md","siteName":"Bothive","nav":{"global":null,"groups":[{"group":"Start Here","pages":[{"title":"Build Your First Agent","description":"A beginner-friendly walkthrough from an empty dashboard to a working Bothive agent.","href":"/guides/first-agent"},{"title":"Connect Your First Tool","href":"/guides/connect-first-tool"},{"title":"Deploy Your First Agent","description":"Move an agent from draft to preview, staging, and production safely.","href":"/guides/deploy-first-agent"},{"title":"Read Your First Trace","href":"/guides/read-your-first-trace"},{"title":"Bothive Beginner Handbook","href":"/guides/beginner-handbook"}]},{"group":"Getting Started","pages":[{"title":"Bothive Documentation","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Why Bothive","href":"/why-bothive"},{"title":"Platform Status","href":"/platform-status"}]},{"group":"Core Concepts","pages":[{"title":"Platform Architecture","href":"/concepts/architecture"},{"title":"Building SaaS Agents","href":"/concepts/saas-agents"},{"title":"HiveLang","href":"/concepts/hivelang"},{"title":"Bothive vs Vercel AI SDK","href":"/concepts/bothive-vs-vercel-ai"},{"title":"Bothive vs LangChain","href":"/concepts/bothive-vs-langchain"},{"title":"Integrations","href":"/concepts/integrations"},{"title":"Deployment Channels","href":"/concepts/channels"},{"title":"Memory System","href":"/concepts/memory"},{"title":"Observability \u0026 Traces","href":"/concepts/observability"}]},{"group":"Building Agents","pages":[{"title":"Build Your First Agent","href":"/guides/build-your-first-agent"},{"title":"Telegram Bots","href":"/guides/telegram-bots"},{"title":"Slack Bots","href":"/guides/slack-bots"},{"title":"Discord Bots","href":"/guides/discord-bots"},{"title":"Gmail Agents","href":"/guides/gmail-agents"},{"title":"Codebase Assistants","href":"/guides/codebase-assistants"},{"title":"Meeting Assistants","href":"/guides/meeting-assistants"},{"title":"Web Widget","href":"/guides/web-widget"},{"title":"Add a Bothive Agent to Mintlify Docs","href":"/guides/mintlify-docs-agent"}]},{"group":"Deployment \u0026 Operations","pages":[{"title":"Production Deployment Guide","href":"/guides/deployment-guide"},{"title":"Deploy to Channels","href":"/guides/deploy-to-channels"},{"title":"Connecting Channels \u0026 Tools","href":"/guides/connect-bot-channels-and-tools"},{"title":"Launch Checklist","href":"/guides/launch-checklist"}]},{"group":"Teams \u0026 Organisations","pages":[{"title":"Organisation Workspaces","href":"/guides/organisation-workspaces"},{"title":"Team Shared Bots","href":"/guides/team-shared-bots"}]},{"group":"Integrations","pages":[{"title":"Integration Capabilities","href":"/guides/integration-capabilities"},{"title":"Custom Integrations","href":"/guides/custom-integrations"}]},{"group":"API Reference","pages":[{"title":"API Reference","href":"/api/overview"},{"title":"Execute API","href":"/api/execute"},{"title":"Deploy API","href":"/api/deploy"},{"title":"Chat API","href":"/api/chat"}]},{"group":"Resources","pages":[{"title":"FAQ","href":"/faq"},{"title":null,"href":"/legacy-docs"}]}]},"basePath":"","title":"Connect Your First Tool - Bothive","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}