When your Builder and Jira accounts are connected, you can:
- Assign Jira tickets to the Builder.io bot to create Builder branches automatically
- Comment with
@Builderin a Jira issue
Connecting your Builder and Jira accounts is a multi-part process that the Builder UI guides you through. The video blow shows the process that this document covers.
- Go to https://api.builder.io/integrations/jira.
- Click the Connect to Jira button.
- On the Atlassian authorization page, choose which Jira site you want to allow access to.
- Review the permission request from Builder and click the Authorize button. This grants Builder access to your Jira instance.
You have two options for how Builder processes tickets from Jira:
- Assignment flow (recommended): assign Jira issues directly to a Builder bot you create.
- Comment flow: create Builder.io boards by commenting
@Builderon Jira issues.
- Open your Jira User Management page.
- Click Invite users.
- Create a new user using an email alias that includes
+builder, for example:yourname+builder@company.com. - Send the invitation — it arrives in your regular inbox.
- Open the invitation email and accept it.
- Login to Jira as the bot user. You might have to use incognito or a different browser.
- Go to
id.atlassian.com/profileand set the Full Name toBuilder.io Bot. - Return to Jira and add the bot to relevant project roles.
To connect your Builder bot to your Jira account:
- Visit your Atlassian API Token page.
- Click the Create API Token button, name, and copy your new API token.
- Return to the Builder integration setup page and paste the API token into the field labeled ** Enter bot user's API token**.
- Click the Configure Bot Credentials.
When you've configured bot credentials, Builder prompts you to register webhooks so the integration can receive notifications when issues are assigned to your bot.
- Click the Register Webhooks button in the integration setup page.
- You should receive the confirmation message: Webhook has been registered successfully.
The last step in the process is to connect your Builder Space:
- Click the Connect to Builder button.
- In the Builder window that opens, select the Builder Space you want to link.
- Click the Authorize button to finalize the connection.
Tag your Builder bot in Slack to request updates. For more information, see Integrate Fusion's Slack Agent.
Was this article helpful?