Skip to content
Skip to main contentAgent-Native Hackathon winners revealed live Nov 13.RSVP
CONTACT SALESSTART BUILDING

Integrate Builder and Jira

Builder Code

Enterprise plans

Team plans

When your Builder and Jira accounts are connected, you can:

  • Assign Jira tickets to the Builder bot to create Builder branches automatically
  • Comment with @Builder in a Jira issue

Connecting your Builder and Jira accounts is a multi-part process that the Builder UI guides you through. The video below shows the process that this document covers.

Set up Jira

Before you connect Builder, make sure you have:

  • A Jira Cloud site. Jira Server and Data Center aren't supported.
  • Admin access to your Jira site, so you can invite a user.
  • For the assignment flow only: a spare Jira license. The Builder bot user you create uses one license.

Integrate Jira

Connect to Jira

  1. Go to https://builder.io/app/projects/integrations/jira.
  2. Click the Connect to Jira button.
  3. On the Atlassian authorization page, choose which Jira site you want to allow access to.
  4. Review the permission request from Builder and click the Authorize button. This grants Builder access to your Jira instance.

Choose a setup method

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: start work in Builder by commenting @Builder on a Jira issue. This flow needs no bot user and no extra Jira license.

The sections Create a Builder bot user and Generate and add an API token apply only to the assignment flow. If you choose the comment flow, skip them and continue with Register webhooks.

Create a Builder bot user

  1. Open your Jira User Management page.
  2. Click Invite users.
  3. Create a new user using an email alias that includes +builder, for example: yourname+builder@company.com.
  4. Send the invitation — it arrives in your regular inbox.
  5. Open the invitation email and accept it.
  6. Log in to Jira as the bot user. You might have to use incognito or a different browser.
  7. Go to id.atlassian.com/profile and set the Full Name to Builder.io Bot.
  8. Return to Jira and add the bot to relevant project roles.

Generate and add an API token

To connect your Builder bot to your Jira account:

  1. Visit your Atlassian API Token page.
  2. Click the Create API token button, name the token, and copy it.
  3. Return to the Builder integration setup page and click I've Created the Bot User. In the Bot User Email field, enter the bot's email address. In the Bot API Token field, paste the API token.
  4. Click the Configure Bot Credentials button.

Choose a flow

On the setup page, click Use Assignment Flow or Use Comment Flow.

Register webhooks

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.

  1. Click the Register Webhooks button in the integration setup page.
  2. You should receive the confirmation message: Webhooks registered successfully! Your integration is now ready for notifications.

Connect your Builder Space

The last step in the process is to connect your Builder Space:

  1. Click the Connect Builder.io Space button.
  2. In the Builder window that opens, select the Builder Space you want to link.
  3. Click the Authorize button to finalize the connection.

Use Jira

  1. Create a new Jira ticket or open an existing one. Specify the Project in the ticket description with project:Name, or project:"Name With Spaces" if the name has spaces. If you leave it out, Builder uses the default Project for the integration. You can set the default in Settings on the Jira tile of the Integrations page.
  2. Assign the ticket to the bot user you created. Its display name is Builder.io Bot, and its email address is the +builder address you used, for example yourname+builder@company.com.

The bot then:

  1. Comments on the ticket confirming it received the assignment.
  2. Creates a branch in the specified project.
  3. Provides the branch URL where changes were made.
  4. Posts as comments on the ticket.

To request follow-up work from the bot in the same branch:

  1. Add comments to the ticket with additional requests.
  2. Tag the bot in the comment. Builder ignores comments that don't mention the bot.

What's next

Tag your Builder bot in Slack to request updates. Visit Integrate Slack to learn more.

To give Builder access to Jira through Atlassian's MCP server instead, visit Connect to Atlassian.

Was this article helpful?