[{"data":1,"prerenderedAt":214},["ShallowReactive",2],{"\u002Fdocs\u002Fguides\u002Fconnect-an-integration":3,"docs-navigation":140,"docs-surround:\u002Fdocs\u002Fguides\u002Fconnect-an-integration":211},{"id":4,"title":5,"body":6,"description":131,"extension":132,"meta":133,"navigation":134,"path":135,"seo":136,"stem":138,"__hash__":139},"docs\u002Fdocs\u002F3.guides\u002F1.connect-an-integration.md","Connect an Integration",{"type":7,"value":8,"toc":121},"minimark",[9,13,18,45,48,52,55,58,73,81,85,88,92,95,98,102,105,108,111,115,118],[10,11,12],"p",{},"Integrations are usually the first setup step. They decide what Gondo can access.",[14,15,17],"h2",{"id":16},"add-the-integration","Add the integration",[19,20,21,30,36,39,42],"ol",{},[22,23,24,25,29],"li",{},"Open ",[26,27,28],"strong",{},"Integrations",".",[22,31,32,33,29],{},"Choose ",[26,34,35],{},"Add integration",[22,37,38],{},"Pick the app, system, or website you want to connect.",[22,40,41],{},"Follow the connection flow.",[22,43,44],{},"Check that the integration appears in the list.",[10,46,47],{},"If the provider supports managed OAuth, you will usually sign in through the provider. If it uses credentials, Gondo will show the fields it needs.",[14,49,51],{"id":50},"give-it-a-useful-label","Give it a useful label",[10,53,54],{},"If you have more than one account for the same service, label the integration by purpose.",[10,56,57],{},"Good labels:",[59,60,61,64,67,70],"ul",{},[22,62,63],{},"Finance Gmail",[22,65,66],{},"Contracts Drive",[22,68,69],{},"Customer Success Trello",[22,71,72],{},"GitHub Product Repo",[10,74,75,76,80],{},"The label is for people. The ",[77,78,79],"code",{},"referenceId"," is the stable name workflows use.",[14,82,84],{"id":83},"check-the-connection","Check the connection",[10,86,87],{},"After connecting, use the connection check when available. This catches common setup problems early, such as an expired token, missing API permission, or incorrect service account data.",[14,89,91],{"id":90},"adjust-tool-access","Adjust tool access",[10,93,94],{},"Some integrations expose many tools. You can restrict access by toolset, read\u002Fwrite scope, or individual tools.",[10,96,97],{},"For a new workflow, start with the access needed for the job. If the workflow only needs to read files, keep it read-only. If it must update cards, sheets, issues, or documents, it needs write access for those actions.",[14,99,101],{"id":100},"use-it-in-a-workflow","Use it in a workflow",[10,103,104],{},"When a workflow step needs an integration, that node should list the integration reference ID.",[10,106,107],{},"For example, a step that reads from a finance mailbox should be allowed to use the finance Gmail integration. A step that writes to a tracker should be allowed to use the tracker integration.",[10,109,110],{},"This keeps workflow access explicit and easier to review.",[14,112,114],{"id":113},"when-to-create-a-custom-integration","When to create a custom integration",[10,116,117],{},"Create a custom integration when the system you need is not in the prebuilt catalog.",[10,119,120],{},"Use a custom API integration when the system has an HTTP API. Use a browser integration when the useful action only exists in a website UI.",{"title":122,"searchDepth":123,"depth":123,"links":124},"",2,[125,126,127,128,129,130],{"id":16,"depth":123,"text":17},{"id":50,"depth":123,"text":51},{"id":83,"depth":123,"text":84},{"id":90,"depth":123,"text":91},{"id":100,"depth":123,"text":101},{"id":113,"depth":123,"text":114},"Add a connected app or system so Gondo can use it in chats and workflows.","md",{},"[object Object]","\u002Fdocs\u002Fguides\u002Fconnect-an-integration",{"title":137,"description":131},"Connect an Integration in Gondo","docs\u002F3.guides\u002F1.connect-an-integration","g4z_jPD2PU9wzbJqIvt9deIg8ZXy5S1eLykTwUhYdmM",[141],{"title":142,"path":143,"stem":144,"children":145},"Docs","\u002Fdocs","docs",[146,150,155,175,186,206],{"title":147,"path":143,"stem":148,"description":149},"Gondo Docs","docs\u002Findex","Learn the basic ideas behind Gondo, from integrations and workflows to runs, approvals, and workflow YAML.",{"title":151,"path":152,"stem":153,"description":154},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started","Connect an integration, ask Gondo for help, build a workflow, and watch it run.",{"title":156,"path":157,"stem":158,"children":159,"page":174},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002F2.concepts",[160,164,169],{"title":28,"path":161,"stem":162,"description":163},"\u002Fdocs\u002Fconcepts\u002Fintegrations","docs\u002F2.concepts\u002F1.integrations","Integrations are the connected apps, accounts, websites, and systems Gondo can use.",{"title":165,"path":166,"stem":167,"description":168},"Workflows","\u002Fdocs\u002Fconcepts\u002Fworkflows","docs\u002F2.concepts\u002F2.workflows","Workflows are repeatable processes made from triggers, AI tasks, code, human review, and edges.",{"title":170,"path":171,"stem":172,"description":173},"Runs and Activity","\u002Fdocs\u002Fconcepts\u002Fruns-and-activity","docs\u002F2.concepts\u002F3.runs-and-activity","Learn what happens when a workflow runs and how to read statuses, approvals, failures, and reauth pauses.",false,{"title":176,"path":177,"stem":178,"children":179,"page":174},"Guides","\u002Fdocs\u002Fguides","docs\u002F3.guides",[180,181],{"title":5,"path":135,"stem":138,"description":131},{"title":182,"path":183,"stem":184,"description":185},"Build Your First Workflow","\u002Fdocs\u002Fguides\u002Fbuild-your-first-workflow","docs\u002F3.guides\u002F2.build-your-first-workflow","A practical walkthrough for turning a plain-English process into a small Gondo workflow.",{"title":187,"path":188,"stem":189,"children":190,"page":174},"Reference","\u002Fdocs\u002Freference","docs\u002F4.reference",[191,196,201],{"title":192,"path":193,"stem":194,"description":195},"Workflow YAML","\u002Fdocs\u002Freference\u002Fworkflow-yaml","docs\u002F4.reference\u002F1.workflow-yaml","The technical shape of Gondo workflow definitions, including version, run display, variables, nodes, edges, and schema rules.",{"title":197,"path":198,"stem":199,"description":200},"Node Types","\u002Fdocs\u002Freference\u002Fnode-types","docs\u002F4.reference\u002F2.node-types","Reference for trigger, task, code, and human nodes, including configs and runtime context.",{"title":202,"path":203,"stem":204,"description":205},"Integration Tools","\u002Fdocs\u002Freference\u002Fintegration-tools","docs\u002F4.reference\u002F3.integration-tools","How integration tools, toolsets, scopes, disabled tools, and custom tools fit together.",{"title":207,"path":208,"stem":209,"description":210},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002F5.troubleshooting","Fix common problems with integrations, workflow runs, human input, browser sessions, and YAML.",[212,213],{"title":170,"path":171,"stem":172,"children":-1},{"title":182,"path":183,"stem":184,"children":-1},1782210444674]