Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.
Overview
Buckle connects AI agents to Jira Cloud. Agents can search issues with JQL, read and create them, comment, and move them through a workflow. The gateway injects the token into requests to api.atlassian.com, so your agent never sees it.Connecting takes one click. You don’t create an Atlassian app or copy any keys.
What you will set up
A Jira Cloud connection through Atlassian OAuth, with no app or keys to create
Automatic token injection on requests to api.atlassian.com
Per-agent, per-tool access, such as approval before deleting issues
Connect Jira
1
Click Connect
In the Buckle dashboard, open Settings > Apps > Jira and click Connect Jira.
The Jira connect window in Buckle.
2
Accept in Atlassian
Sign in to Atlassian, pick your Jira site, and click Accept. You’re done. Buckle keeps the connection active from then on.
You don’t need to be a Jira admin. Atlassian may show a notice that the app hasn’t been reviewed by Atlassian yet. It’s safe to continue.
What agents can do
Tool
Description
Search issues
Find issues with JQL
Get issue
Read an issue and its sub-resources
List projects / Get project
List projects in the site, or read one
Create issue / Update issue
Open a new issue, or change its fields
Add comment
Comment on an issue
Transition issue
Move an issue through its workflow
Assign issue
Assign an issue to a user
Delete issue
Delete an issue
Controlling access
Grant the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what’s blocked. For example, let an agent search and read freely, but put Transition issue and Delete issue behind approval. Organization rules add guardrails on top. A blocked request never reaches Jira.To disconnect, remove the connection in Settings > Apps > Jira, then revoke Buckle in Atlassian under Account settings > Connected apps.
Self-hosted: use your own Atlassian app
Skip this section on Buckle Cloud. It’s only for self-hosted Buckle without ATLASSIAN_CLIENT_ID and ATLASSIAN_CLIENT_SECRET set, or if you want your own company name on Atlassian’s consent screen. One Atlassian app serves both Jira and Confluence: you save it once, register one callback URL, and people connect either app with it.
1. Create the Atlassian app
Go to developer.atlassian.com/console/myapps. Select Create > OAuth 2.0 integration, name it Buckle, accept the terms, and select Create. For Access type, choose Resource-level, so the token only reaches the site you pick.
2. Add the permissions
Open Permissions. For each API, click Add, then Configure:
API
Scopes
Jira API
read:jira-work, write:jira-work, read:jira-user
User identity API
read:me
Use these exact classic scope names. The granular ones (read:issue:jira and so on) don’t match what Buckle requests.
Also add the Confluence scopes from the Confluence page, even if you only use Jira. Atlassian keeps one consent per person for each app, so Buckle asks for the Jira and Confluence scopes together. If any of them is missing from the app, Atlassian shows an error instead of the consent screen.
Permissions after adding all four scopes.
3. Add the callback URL
In Buckle, open Settings > Apps > Jira > Custom credentials and copy the Redirect URI. It ends in /v1/apps/oauth/atlassian/callback, the same URI for Jira and Confluence. In the developer console, open Authorization, click Configure next to OAuth 2.0 (3LO), paste it into Callback URLs, and save.
Copy the Redirect URI from Custom credentials in Buckle.
4. Connect with your app
In the developer console, open Settings and copy the Client ID and Secret under Authentication details.
Client ID and Secret on the Settings page.
Paste both into Settings > Apps > Jira > Custom credentials, select Save credentials, then Connect and accept in Atlassian. The app now serves Confluence too: connect it from Settings > Apps > Confluence without entering credentials again.
An Atlassian app has only one callback URL. If your app still has an older per-app URI (ending in /v1/apps/jira/callback), replace it with the one above.
FAQ
Do I need to be a Jira admin to connect?
No. Any Jira user can connect. Atlassian may show a notice that the app hasn’t been reviewed yet, and it’s safe to continue.
Does the agent see my Atlassian token?
No. The token stays in Buckle, and the gateway adds it at the proxy. See How it works.
Can I stop agents from deleting issues?
Yes. Block Delete issue or put it behind approval when you grant the connection.
Does one Atlassian connection cover Confluence too?
On self-hosted, one Atlassian app serves both Jira and Confluence.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Buckle","colors":{"primary":"#ff6a13","light":"#ff8236","dark":"#e55e0f"},"logo":{"light":"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=30ceea1dd3505e0e9dea50b544521ced","dark":"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-dark.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=120ef96cf376422549781454d97dd810","href":"https://buckle.dev"},"favicon":"https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/favicon.svg?fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=ddda982106e5fd52c3815a54c183f4b1","appearance":{"default":"light"},"background":{"color":{"light":"#FAFAF9","dark":"#1A1918"}},"navbar":{"links":[{"href":"https://github.com/trybuckle/buckle","label":"GitHub"},{"href":"https://buckle.dev","label":"Install"}]},"footer":{"socials":{"github":"https://github.com/trybuckle"}},"fonts":{"heading":{"family":"Chakra Petch","weight":700,"source":"fonts/ChakraPetch-700.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/onecli-17d3f772/images/github.svg","href":"https://github.com/buckle"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onecli-17d3f772","hasAudioNarration":false,"actualSubdomain":"onecli-17d3f772","customDomains":[],"gitSource":{"type":"github","owner":"trybuckle","repo":"buckle-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6af9ac749033d7e87e8c505a"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af9b4b9e79e0e5d703531fb","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":240},{"language":"default","tag":"Workspace","count":105},{"language":"default","tag":"Integrations","count":88},{"language":"default","tag":"All app connections","count":64},{"language":"default","tag":"Enterprise","count":57},{"language":"default","tag":"Organization","count":52},{"language":"default","tag":"Apps","count":29},{"language":"default","tag":"Channels","count":28},{"language":"default","tag":"Platform","count":21},{"language":"default","tag":"Guides","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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":"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":"style.css","content":"a.nav-anchor div.mr-4.rounded-md{--tw-ring-color: transparent !important;--tw-ring-shadow: 0 0 0 0 transparent !important;--tw-ring-offset-shadow: 0 0 0 0 transparent !important;box-shadow:none!important;background:transparent!important;filter:none!important;transition:opacity 0.15s ease!important}a.nav-anchor:hover div.mr-4.rounded-md{--tw-ring-color: transparent !important;--tw-ring-shadow: 0 0 0 0 transparent !important;--tw-ring-offset-shadow: 0 0 0 0 transparent !important;box-shadow:none!important;background:transparent!important;filter:none!important;opacity:0.7!important}a.nav-anchor div.mr-4.rounded-md img{opacity:1!important;filter:none!important;background:transparent!important}a.nav-anchor:hover div.mr-4.rounded-md img{opacity:1!important;filter:none!important;background:transparent!important}.dark a.nav-anchor div.mr-4.rounded-md img,[data-theme=\"dark\"] a.nav-anchor div.mr-4.rounded-md img{filter:invert(1)!important}"}],"page":{"pagePath":"integrations/jira","slug":"/integrations/jira","pageMetadata":{"title":"Let AI Agents Create and Triage Jira Issues","sidebarTitle":"Jira","description":"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.","canonical":"https://buckle.dev/docs/integrations/jira","href":"/integrations/jira"},"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: \"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.\"\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={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Buckle connects AI agents to Jira Cloud. Agents can search issues with JQL, read and create them, comment, and move them through a workflow. The gateway injects the token into requests to `,_jsx(_components.code,{children:`api.atlassian.com`}),`, so your agent never sees it.`]}),`\n`,_jsx(_components.p,{children:`Connecting takes one click. You don’t create an Atlassian app or copy any keys.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-will-set-up`,children:`What you will set up`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A Jira Cloud connection through Atlassian OAuth, with no app or keys to create`}),`\n`,_jsxs(_components.li,{children:[`Automatic token injection on requests to `,_jsx(_components.code,{children:`api.atlassian.com`})]}),`\n`,_jsx(_components.li,{children:`Per-agent, per-tool access, such as approval before deleting issues`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-jira`,children:`Connect Jira`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Click Connect`,children:[_jsxs(_components.p,{children:[`In the Buckle dashboard, open `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Jira`}),` and click `,_jsx(_components.strong,{children:`Connect Jira`}),`.`]}),_jsx(Frame,{caption:`The Jira connect window in Buckle.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-connect-jira.png?fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=dba36145d981728d6e130c96ae5d10c3`,alt:`Buckle connect window for Jira, showing the Connect to Jira button and an auto-connect countdown.`,\"data-og-width\":`960`,width:`960`,\"data-og-height\":`1062`,height:`1062`,\"data-path\":`images/integrations/jira/buckle-connect-jira.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-connect-jira.png?w=280\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=d664152bd9dcb20924a4d03379cdb2ca 280w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-connect-jira.png?w=560\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=1879d2b30e2d1e54dc58e1e4123abf6e 560w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-connect-jira.png?w=840\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=eeda8d54b4cf97e33274404db6c6b9f4 840w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-connect-jira.png?w=1100\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=7a54f9b8f5c59fa25e0a9c766cb2944e 1100w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-connect-jira.png?w=1650\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=c2164af8bd572913e81b731e0528111c 1650w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-connect-jira.png?w=2500\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=e1829e75d5c284134eb4e71f668f380b 2500w`})})]}),_jsx(Step,{title:`Accept in Atlassian`,children:_jsxs(_components.p,{children:[`Sign in to Atlassian, pick your Jira site, and click `,_jsx(_components.strong,{children:`Accept`}),`. You’re done. Buckle keeps the connection active from then on.`]})})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`You don’t need to be a Jira admin. Atlassian may show a notice that the app hasn’t been reviewed by Atlassian yet. It’s safe to continue.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what-agents-can-do`,children:`What agents can do`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Search issues`})}),_jsx(_components.td,{children:`Find issues with JQL`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Get issue`})}),_jsx(_components.td,{children:`Read an issue and its sub-resources`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`List projects`}),` / `,_jsx(_components.strong,{children:`Get project`})]}),_jsx(_components.td,{children:`List projects in the site, or read one`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Create issue`}),` / `,_jsx(_components.strong,{children:`Update issue`})]}),_jsx(_components.td,{children:`Open a new issue, or change its fields`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Add comment`})}),_jsx(_components.td,{children:`Comment on an issue`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Transition issue`})}),_jsx(_components.td,{children:`Move an issue through its workflow`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Assign issue`})}),_jsx(_components.td,{children:`Assign an issue to a user`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delete issue`})}),_jsx(_components.td,{children:`Delete an issue`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`controlling-access`,children:`Controlling access`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/guides/agent-access`,children:`Grant`}),` the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what’s blocked. For example, let an agent search and read freely, but put `,_jsx(_components.strong,{children:`Transition issue`}),` and `,_jsx(_components.strong,{children:`Delete issue`}),` behind approval. Organization `,_jsx(_components.a,{href:`/guides/rules`,children:`rules`}),` add guardrails on top. A blocked request never reaches Jira.`]}),`\n`,_jsxs(_components.p,{children:[`To disconnect, remove the connection in `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Jira`}),`, then revoke Buckle in Atlassian under `,_jsx(_components.strong,{children:`Account settings`}),` > `,_jsx(_components.strong,{children:`Connected apps`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(`a`,{id:`self-hosted`,style:{scrollMarginTop:`8rem`}}),`\n`,_jsx(Heading,{level:`2`,id:`self-hosted-use-your-own-atlassian-app`,children:`Self-hosted: use your own Atlassian app`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Skip this section on Buckle Cloud.`}),` It’s only for self-hosted Buckle without `,_jsx(_components.code,{children:`ATLASSIAN_CLIENT_ID`}),` and `,_jsx(_components.code,{children:`ATLASSIAN_CLIENT_SECRET`}),` set, or if you want your own company name on Atlassian’s consent screen. One Atlassian app serves both Jira and Confluence: you save it once, register one callback URL, and people connect either app with it.`]})}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`1. Create the Atlassian app`,defaultOpen:true,id:`1-create-the-atlassian-app`,children:_jsxs(_components.p,{children:[`Go to `,_jsx(_components.a,{href:`https://developer.atlassian.com/console/myapps/`,children:`developer.atlassian.com/console/myapps`}),`. Select `,_jsx(_components.strong,{children:`Create`}),` > `,_jsx(_components.strong,{children:`OAuth 2.0 integration`}),`, name it `,_jsx(_components.code,{children:`Buckle`}),`, accept the terms, and select `,_jsx(_components.strong,{children:`Create`}),`. For `,_jsx(_components.strong,{children:`Access type`}),`, choose `,_jsx(_components.strong,{children:`Resource-level`}),`, so the token only reaches the site you pick.`]})}),_jsxs(Accordion,{title:`2. Add the permissions`,id:`2-add-the-permissions`,children:[_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Permissions`}),`. For each API, click `,_jsx(_components.strong,{children:`Add`}),`, then `,_jsx(_components.strong,{children:`Configure`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`API`}),_jsx(_components.th,{children:`Scopes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Jira API`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`read:jira-work`}),`, `,_jsx(_components.code,{children:`write:jira-work`}),`, `,_jsx(_components.code,{children:`read:jira-user`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`User identity API`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`read:me`})})]})]})]}),_jsxs(_components.p,{children:[`Use these exact classic scope names. The granular ones (`,_jsx(_components.code,{children:`read:issue:jira`}),` and so on) don’t match what Buckle requests.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Also add the Confluence scopes from the `,_jsx(_components.a,{href:`/integrations/confluence#self-hosted-use-your-own-atlassian-app`,children:`Confluence page`}),`, even if you only use Jira. Atlassian keeps one consent per person for each app, so Buckle asks for the Jira and Confluence scopes together. If any of them is missing from the app, Atlassian shows an error instead of the consent screen.`]})}),_jsx(Frame,{caption:`Permissions after adding all four scopes.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/02-permissions.png?fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=54e944b0c6a28c2c389d3384f93cd2ca`,alt:`Atlassian developer console Permissions page showing Scopes Used 4, with the Jira API row at 3 scopes and the User identity API row at 1 scope.`,\"data-og-width\":`2360`,width:`2360`,\"data-og-height\":`1180`,height:`1180`,\"data-path\":`images/integrations/jira/02-permissions.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/02-permissions.png?w=280\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=b519d92c0a45243024d2913fe99eaf7b 280w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/02-permissions.png?w=560\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=9c30defd1c8e4c1aa8445fbf63eada4b 560w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/02-permissions.png?w=840\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=a196cc5459225ad904abb7356a47e582 840w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/02-permissions.png?w=1100\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=32979503c5a28a30b9f66a45746cd508 1100w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/02-permissions.png?w=1650\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=afd5e86df9f6f9b22458c55bad29d986 1650w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/02-permissions.png?w=2500\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=dc92bf8b2f8f82387f7eeebbdc3b3d53 2500w`})})]}),_jsxs(Accordion,{title:`3. Add the callback URL`,id:`3-add-the-callback-url`,children:[_jsxs(_components.p,{children:[`In Buckle, open `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Jira`}),` > `,_jsx(_components.strong,{children:`Custom credentials`}),` and copy the `,_jsx(_components.strong,{children:`Redirect URI`}),`. It ends in `,_jsx(_components.code,{children:`/v1/apps/oauth/atlassian/callback`}),`, the same URI for Jira and Confluence. In the developer console, open `,_jsx(_components.strong,{children:`Authorization`}),`, click `,_jsx(_components.strong,{children:`Configure`}),` next to OAuth 2.0 (3LO), paste it into `,_jsx(_components.strong,{children:`Callback URLs`}),`, and save.`]}),_jsx(Frame,{caption:`Copy the Redirect URI from Custom credentials in Buckle.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-custom-credentials-jira.png?fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=9608539ea16eeeaf094b82d18199d167`,alt:`Buckle Custom credentials card for Jira with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.`,\"data-og-width\":`1712`,width:`1712`,\"data-og-height\":`852`,height:`852`,\"data-path\":`images/integrations/jira/buckle-custom-credentials-jira.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-custom-credentials-jira.png?w=280\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=a3512c5c6702978afb1e823e7fea62d0 280w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-custom-credentials-jira.png?w=560\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=0a9d70966b6fb1644ccab0d45d5d49cf 560w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-custom-credentials-jira.png?w=840\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=574eaac4041165040cdcb07a2afa6dfb 840w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-custom-credentials-jira.png?w=1100\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=31b74b9f4f2fade059ec7e94bcec738c 1100w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-custom-credentials-jira.png?w=1650\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=e32b9628c1544c018c3037e3f9e21a66 1650w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/buckle-custom-credentials-jira.png?w=2500\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=87af1c75d6650d2e3c8d63bcd1c4b8d4 2500w`})})]}),_jsxs(Accordion,{title:`4. Connect with your app`,id:`4-connect-with-your-app`,children:[_jsxs(_components.p,{children:[`In the developer console, open `,_jsx(_components.strong,{children:`Settings`}),` and copy the `,_jsx(_components.strong,{children:`Client ID`}),` and `,_jsx(_components.strong,{children:`Secret`}),` under `,_jsx(_components.strong,{children:`Authentication details`}),`.`]}),_jsx(Frame,{caption:`Client ID and Secret on the Settings page.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/04-settings-credentials.png?fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=a7e7762893e8bd52adf9ffc1e9e43841`,alt:`Atlassian developer console Settings page showing the Authentication details card with a Client ID field and a masked Secret field, each with a copy button.`,\"data-og-width\":`1250`,width:`1250`,\"data-og-height\":`260`,height:`260`,\"data-path\":`images/integrations/jira/04-settings-credentials.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/04-settings-credentials.png?w=280\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=1702007dfca7ab266a5dcb50ec6ec0f3 280w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/04-settings-credentials.png?w=560\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=1c977815024317ebd2faf2ac87110284 560w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/04-settings-credentials.png?w=840\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=e6307bede5b57fb0a8cc1c8613b5910c 840w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/04-settings-credentials.png?w=1100\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=1a58307992409f3656c9dd981a3ecfc1 1100w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/04-settings-credentials.png?w=1650\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=b04060fcf9c989785034804a4e3c3679 1650w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/jira/04-settings-credentials.png?w=2500\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=9d38bc496789747f61a1141d06cdce5c 2500w`})}),_jsxs(_components.p,{children:[`Paste both into `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Jira`}),` > `,_jsx(_components.strong,{children:`Custom credentials`}),`, select `,_jsx(_components.strong,{children:`Save credentials`}),`, then `,_jsx(_components.strong,{children:`Connect`}),` and accept in Atlassian. The app now serves Confluence too: connect it from `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Confluence`}),` without entering credentials again.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`An Atlassian app has only one callback URL. If your app still has an older per-app URI (ending in `,_jsx(_components.code,{children:`/v1/apps/jira/callback`}),`), replace it with the one above.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Do I need to be a Jira admin to connect?`,id:`do-i-need-to-be-a-jira-admin-to-connect`,children:_jsx(_components.p,{children:`No. Any Jira user can connect. Atlassian may show a notice that the app hasn’t been reviewed yet, and it’s safe to continue.`})}),_jsx(Accordion,{title:`Does the agent see my Atlassian token?`,id:`does-the-agent-see-my-atlassian-token`,children:_jsxs(_components.p,{children:[`No. The token stays in Buckle, and the gateway adds it at the proxy. See `,_jsx(_components.a,{href:`/how-it-works`,children:`How it works`}),`.`]})}),_jsx(Accordion,{title:`Can I stop agents from deleting issues?`,id:`can-i-stop-agents-from-deleting-issues`,children:_jsxs(_components.p,{children:[`Yes. Block `,_jsx(_components.strong,{children:`Delete issue`}),` or put it behind approval when you `,_jsx(_components.a,{href:`/guides/agent-access`,children:`grant`}),` the connection.`]})}),_jsx(Accordion,{title:`Does one Atlassian connection cover Confluence too?`,id:`does-one-atlassian-connection-cover-confluence-too`,children:_jsxs(_components.p,{children:[`On self-hosted, one Atlassian app serves both Jira and `,_jsx(_components.a,{href:`/integrations/confluence`,children:`Confluence`}),`.`]})})]})]})}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":"Let AI Agents Create and Triage Jira Issues","sidebarTitle":"Jira","description":"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.","canonical":"https://buckle.dev/docs/integrations/jira","href":"/integrations/jira"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"What you will set up","slug":"what-you-will-set-up","depth":2,"children":[]},{"title":"Connect Jira","slug":"connect-jira","depth":2,"children":[]},{"title":"What agents can do","slug":"what-agents-can-do","depth":2,"children":[]},{"title":"Controlling access","slug":"controlling-access","depth":2,"children":[]},{"title":"Self-hosted: use your own Atlassian app","slug":"self-hosted-use-your-own-atlassian-app","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/onecli-17d3f772/e8c5fc0faf4d8de9/infra/cloudfront/docs-response-headers.js"],"subdomain":"onecli-17d3f772","siteName":"Buckle","title":"Let AI Agents Create and Triage Jira Issues - Buckle","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T13:34:02.491Z","originalFileLocation":"integrations/jira.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=\"light\"}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=\"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Buckle\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_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=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Let AI Agents Create and Triage Jira Issues - Buckle\">\u003cmeta data-mint-head property=\"og:description\" content=\"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Buckle\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://buckle.dev/docs/integrations/jira\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onecli-17d3f772.mintlify.site/docs/_mintlify/api/og/v2?division=All+app+connections\u0026amp;title=Let+AI+Agents+Create+and+Triage+Jira+Issues\u0026amp;description=Let+agents+search+Jira+with+JQL%2C+create+and+update+issues%2C+comment%2C+and+move+tickets+through+workflows.+Connect+in+one+click+with+Atlassian+OAuth.\u0026amp;theme=14ca75cbbb2a0e9ba5cd5703\u0026amp;signature=a997abd2aa20d742aa904127af55248178cd9b171691e2838a175906ef49feee\">\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=\"Let AI Agents Create and Triage Jira Issues - Buckle\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onecli-17d3f772.mintlify.site/docs/_mintlify/api/og/v2?division=All+app+connections\u0026amp;title=Let+AI+Agents+Create+and+Triage+Jira+Issues\u0026amp;description=Let+agents+search+Jira+with+JQL%2C+create+and+update+issues%2C+comment%2C+and+move+tickets+through+workflows.+Connect+in+one+click+with+Atlassian+OAuth.\u0026amp;theme=14ca75cbbb2a0e9ba5cd5703\u0026amp;signature=a997abd2aa20d742aa904127af55248178cd9b171691e2838a175906ef49feee\">\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=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Buckle\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff6a13\">\u003clink data-mint-head rel=\"canonical\" href=\"https://buckle.dev/docs/integrations/jira\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/integrations/jira.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\",\"name\":\"Buckle\",\"url\":\"https://onecli-17d3f772.mintlify.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=30ceea1dd3505e0e9dea50b544521ced\"}},{\"@type\":\"WebSite\",\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\",\"name\":\"Buckle\",\"url\":\"https://onecli-17d3f772.mintlify.dev/docs\",\"publisher\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://buckle.dev/docs/integrations/jira#webpage\",\"url\":\"https://buckle.dev/docs/integrations/jira\",\"name\":\"Let AI Agents Create and Triage Jira Issues\",\"description\":\"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.\",\"dateModified\":\"2026-11-15T13:34:02.491Z\",\"isPartOf\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://buckle.dev/docs/integrations/jira#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://buckle.dev/docs/integrations/jira#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"All app connections\",\"item\":\"https://onecli-17d3f772.mintlify.dev/docs/integrations/affinity\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Let AI Agents Create and Triage Jira Issues\",\"item\":\"https://buckle.dev/docs/integrations/jira\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://buckle.dev/docs/integrations/jira#article\",\"headline\":\"Let AI Agents Create and Triage Jira Issues\",\"name\":\"Let AI Agents Create and Triage Jira Issues\",\"description\":\"Let agents search Jira with JQL, create and update issues, comment, and move tickets through workflows. Connect in one click with Atlassian OAuth.\",\"url\":\"https://buckle.dev/docs/integrations/jira\",\"mainEntityOfPage\":{\"@id\":\"https://buckle.dev/docs/integrations/jira#webpage\"},\"dateModified\":\"2026-11-15T13:34:02.491Z\",\"publisher\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Buckle\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Buckle\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/integrations/jira.md","siteName":"Buckle","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/onecli-17d3f772/images/github.svg","href":"https://github.com/buckle"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Integrations","groups":[{"group":"Integrations","root":{"title":"Integrations: Connect Agents to External Services","sidebarTitle":"Overview","href":"/integrations"},"pages":[{"title":"App Connections: How OAuth \u0026 API Keys Work","sidebarTitle":"App Connections","href":"/integrations/app-connections"},{"title":"Custom Connections: Connect Any API With a Key","sidebarTitle":"Custom connections","href":"/integrations/custom-connections"},{"title":"Chat With AI Agents and Approve Actions in Slack","sidebarTitle":"Slack","href":"/integrations/slack"},{"title":"Keep LLM API Keys Out of Your AI Agents","sidebarTitle":"LLMs","href":"/integrations/llms"},{"title":"External Vaults: Connect Password Managers","sidebarTitle":"External Vaults","href":"/vaults/overview"}]},{"group":"Cloud integrations","pages":[{"title":"Prospect and Enrich Leads in Apollo.io With Agents","sidebarTitle":"Apollo.io","href":"/integrations/apollo-io"},{"title":"Use AWS From AI Agents Without Exposing Keys","sidebarTitle":"AWS","href":"/integrations/aws"},{"title":"Let AI Agents Open PRs and Issues on GitHub","sidebarTitle":"GitHub","href":"/integrations/github"},{"title":"Org-Approved GitHub Repo Access for AI Agents","sidebarTitle":"GitHub App","href":"/integrations/github-app"},{"title":"Let AI Agents Query Datadog Metrics and Monitors","sidebarTitle":"Datadog","href":"/integrations/datadog"},{"title":"Let AI Agents Update HubSpot CRM Records","sidebarTitle":"HubSpot","href":"/integrations/hubspot"},{"title":"Let AI Agents Triage Sentry Errors","sidebarTitle":"Sentry","href":"/integrations/sentry"},{"title":"Let AI Agents Read and Write OneNote Notebooks","sidebarTitle":"Microsoft OneNote","href":"/integrations/microsoft-onenote"},{"title":"Connect AI Agents to Outlook Mail in Microsoft 365","sidebarTitle":"Outlook Mail","href":"/integrations/outlook-mail"},{"title":"Let AI Agents Book Meetings in Outlook Calendar","sidebarTitle":"Outlook Calendar","href":"/integrations/outlook-calendar"}]},{"group":"All app connections","pages":[{"title":"Connect AI Agents to Affinity CRM With an API Key","sidebarTitle":"Affinity","href":"/integrations/affinity"},{"title":"Let AI Agents Manage Attio CRM Records","sidebarTitle":"Attio","href":"/integrations/attio"},{"title":"Run Clay Enrichment From AI Agents","sidebarTitle":"Clay","href":"/integrations/clay"},{"title":"Query PostHog Analytics and Flags From Agents","sidebarTitle":"PostHog","href":"/integrations/posthog"},{"title":"Connect AI Agents to Salesforce With an External App","sidebarTitle":"Salesforce","href":"/integrations/salesforce"},{"title":"Turn Timeless Meetings Into Agent Follow-Ups","sidebarTitle":"Timeless","href":"/integrations/timeless"},{"title":"Let Agents Search Circleback Meeting Notes","sidebarTitle":"Circleback","href":"/integrations/circleback"},{"title":"Run HeyReach LinkedIn Campaigns From AI Agents","sidebarTitle":"HeyReach","href":"/integrations/heyreach"},{"title":"Automate Dripify LinkedIn Outreach With Agents","sidebarTitle":"Dripify","href":"/integrations/dripify"},{"title":"Let On-Call Agents Triage PagerDuty Incidents","sidebarTitle":"PagerDuty","href":"/integrations/pagerduty"},{"title":"Query Coralogix Logs and Metrics From Agents","sidebarTitle":"Coralogix","href":"/integrations/coralogix"},{"title":"Search Company Knowledge in Onyx From Agents","sidebarTitle":"Onyx","href":"/integrations/onyx"},{"title":"Scoped Cloudflare API Tokens for AI Agents","sidebarTitle":"Cloudflare","href":"/integrations/cloudflare"},{"title":"Set Up One Google OAuth Client for All Google Apps","sidebarTitle":"Google (setup)","href":"/integrations/google"},{"title":"Let AI Agents Search, Draft, and Send Gmail","sidebarTitle":"Gmail","href":"/integrations/gmail"},{"title":"Let AI Agents Schedule Meetings in Google Calendar","sidebarTitle":"Google Calendar","href":"/integrations/google-calendar"},{"title":"Give AI Agents Access to Google Drive Files","sidebarTitle":"Google Drive","href":"/integrations/google-drive"},{"title":"Let AI Agents Draft and Edit Google Docs","sidebarTitle":"Google Docs","href":"/integrations/google-docs"},{"title":"Let AI Agents Read and Update Google Sheets","sidebarTitle":"Google Sheets","href":"/integrations/google-sheets"},{"title":"Generate Google Slides Decks With AI Agents","sidebarTitle":"Google Slides","href":"/integrations/google-slides"},{"title":"Build Google Forms and Read Responses With Agents","sidebarTitle":"Google Forms","href":"/integrations/google-forms"},{"title":"Create Google Meet Links From AI Agents","sidebarTitle":"Google Meet","href":"/integrations/google-meet"},{"title":"Search and Organize Google Photos With AI Agents","sidebarTitle":"Google Photos","href":"/integrations/google-photos"},{"title":"Track To-Dos in Google Tasks From AI Agents","sidebarTitle":"Google Tasks","href":"/integrations/google-tasks"},{"title":"Automate Google Workspace User Admin With Agents","sidebarTitle":"Google Admin","href":"/integrations/google-admin"},{"title":"Pull GA4 Reports Into AI Agents","sidebarTitle":"Google Analytics","href":"/integrations/google-analytics"},{"title":"Let AI Agents Check Indexing in Search Console","sidebarTitle":"Google Search Console","href":"/integrations/google-search-console"},{"title":"Automate Google Classroom Coursework With Agents","sidebarTitle":"Google Classroom","href":"/integrations/google-classroom"},{"title":"Manage YouTube Playlists and Analytics With Agents","sidebarTitle":"YouTube","href":"/integrations/youtube"},{"title":"Let AI Agents Search and Update Notion Pages","sidebarTitle":"Notion","description":"Let agents search Notion, read pages, create notes, and query databases. Connect with OAuth, pick which pages to share, and keep tokens out of the agent.","href":"/integrations/notion"},{"title":"Let AI Agents Create and Triage Jira Issues","sidebarTitle":"Jira","href":"/integrations/jira"},{"title":"Give AI Agents Search and Edit Access to Confluence","sidebarTitle":"Confluence","description":"Let agents search Confluence with CQL, read pages, and publish updates. Connect in one click with OAuth, and the gateway keeps the token hidden.","href":"/integrations/confluence"},{"title":"Let AI Agents Manage Your Todoist Tasks","sidebarTitle":"Todoist","href":"/integrations/todoist"},{"title":"Give AI Agents Safe Access to Your Dropbox Files","sidebarTitle":"Dropbox","href":"/integrations/dropbox"},{"title":"Deploy to Fly.io From an Agent Without Exposing Tokens","sidebarTitle":"Fly.io","href":"/integrations/flyio"},{"title":"Let AI Agents Post to LinkedIn on Your Behalf","sidebarTitle":"LinkedIn","href":"/integrations/linkedin"},{"title":"Connect AI Agents to Monday.com Boards","sidebarTitle":"Monday.com","href":"/integrations/monday"},{"title":"Administer MongoDB Atlas Clusters With Agents","sidebarTitle":"MongoDB Atlas","href":"/integrations/mongodb-atlas"},{"title":"Sync Navan Bookings and Expenses With AI Agents","sidebarTitle":"Navan","href":"/integrations/navan"},{"title":"Let AI Agents Send Email With Resend","sidebarTitle":"Resend","href":"/integrations/resend"},{"title":"Send SMS and WhatsApp From AI Agents With Twilio","sidebarTitle":"Twilio","href":"/integrations/twilio"},{"title":"Zendesk Integration: Tickets and Help Center","sidebarTitle":"Zendesk","href":"/integrations/zendesk"},{"title":"Manage Supabase Projects With AI Agents","sidebarTitle":"Supabase","href":"/integrations/supabase"},{"title":"Call Claude and Gemini on Vertex AI From Agents","sidebarTitle":"Vertex AI","href":"/integrations/vertex-ai"},{"title":"Let AI Agents Edit Webflow CMS and Publish Sites","sidebarTitle":"Webflow","href":"/integrations/webflow"},{"title":"Let AI Agents Schedule Zoom Meetings and Get Recordings","sidebarTitle":"Zoom","href":"/integrations/zoom"},{"title":"Give Agents AWS Access With an IAM Role, Not Keys","sidebarTitle":"AWS Role","href":"/integrations/aws-role"},{"title":"Bitbucket Repos, Pull Requests, and Pipelines","sidebarTitle":"Bitbucket","href":"/integrations/bitbucket"},{"title":"Manage Docker Hub Repositories From AI Agents","sidebarTitle":"Docker Hub","href":"/integrations/docker"},{"title":"Read Fathom Meeting Summaries From AI Agents","sidebarTitle":"Fathom","href":"/integrations/fathom"},{"title":"Give AI Agents Access to Fireflies Transcripts","sidebarTitle":"Fireflies","href":"/integrations/fireflies"},{"title":"Let AI Agents Work With GitLab Merge Requests","sidebarTitle":"GitLab","href":"/integrations/gitlab"},{"title":"Send Google Chat Messages From AI Agents","sidebarTitle":"Google Chat","href":"/integrations/google-chat"},{"title":"Let AI Agents Look Up and Update Google Contacts","sidebarTitle":"Google Contacts","href":"/integrations/google-contacts"},{"title":"Let AI Agents Read Your Granola Meeting Notes","sidebarTitle":"Granola","href":"/integrations/granola"},{"title":"Route Agent Package Installs Through JFrog","sidebarTitle":"JFrog Artifactory","href":"/integrations/jfrog-artifactory"},{"title":"Let AI Agents File and Update Linear Issues","sidebarTitle":"Linear","href":"/integrations/linear"},{"title":"Run Snowflake SQL From an Agent, Token Hidden","sidebarTitle":"Snowflake","href":"/integrations/snowflake"},{"title":"Use a Restricted Stripe Key With AI Agents","sidebarTitle":"Stripe","href":"/integrations/stripe"},{"title":"Let AI Agents Manage Trello Boards and Cards","sidebarTitle":"Trello","href":"/integrations/trello"},{"title":"Let AI Agents Deploy and Manage Vercel Projects","sidebarTitle":"Vercel","href":"/integrations/vercel"},{"title":"Let AI Agents Post and Read on X (Twitter)","sidebarTitle":"X","href":"/integrations/x"},{"title":"Let AI Agents Work Zoho CRM Leads and Deals","sidebarTitle":"Zoho CRM","href":"/integrations/zoho-crm"},{"title":"Let AI Agents Draft Word Docs in OneDrive","sidebarTitle":"Microsoft Word","href":"/integrations/microsoft-word"}]},{"group":"LLMs","pages":[{"title":"Connect Claude to Agents With a Token or API Key","sidebarTitle":"Anthropic","href":"/integrations/anthropic"},{"title":"Use OpenAI API Keys and Codex OAuth With AI Agents","sidebarTitle":"OpenAI","href":"/integrations/openai"}]},{"group":"External Vaults","pages":[{"title":"Bitwarden Vault: Sync Secrets to the Gateway","sidebarTitle":"Bitwarden","href":"/vaults/bitwarden"},{"title":"1Password Vault: Service Account Integration","sidebarTitle":"1Password","href":"/vaults/1password"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]}]},"basePath":"","title":"Let AI Agents Create and Triage Jira Issues - Buckle","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-0domioUa.js","DynamicMarkdown-BcGRTrw6.js","zoom-image-lightbox-DsiWwPWR.js","lightbox-handle-r17bVUz3.js"]}