Jira Integration

Connect Pointing Poker with your Jira instance to seamlessly import stories from your Scrum boards. This integration allows you to pull in your backlog items directly, making sprint planning more efficient.

Note: Currently supports Scrum boards only, as they are specifically designed for story point estimation.

Step 1: Generate a Jira API Token

  1. Log in to your Atlassian account at https://id.atlassian.com
  2. Navigate to Security → API tokens
  3. Click "Create API token"
  4. Give your token a descriptive label (e.g., "Pointing Poker Integration")
  5. Click "Create" and copy the token immediately - you won't be able to see it again

Step 2: Required Permissions

Your API token needs the following scopes to work with Pointing Poker:

  • read:jira-work - Read projects, issues, boards, and sprints
  • write:jira-work - Update story points on issues

For standard API tokens, these permissions are included by default based on your Jira user permissions. If you're using a scoped API token for enhanced security, make sure to select these specific scopes when creating the token.

Step 3: Configure in Pointing Poker

  1. Open your Pointing Poker room
  2. Click on the Jira Integration toggle
  3. Enter your Jira instance URL (e.g., https://yourcompany.atlassian.net)
  4. Enter your Jira project key (e.g., "MYPROJECT")
  5. Enter your email address associated with your Jira account
  6. Paste the API token you generated in Step 1
  7. Click "Fetch Projects" to retrieve a list of projects to choose from
  8. Select your desired project from the dropdown
  9. Click "Connect to Jira"
  10. If successful, you'll see a confirmation message and can now import stories

Step 4: Import Stories

  1. Select your Scrum board from the dropdown
  2. Choose the sprint or backlog you want to import from
  3. Click "Fetch Issues" to load stories from Jira
  4. Select the stories you want to estimate (or select all)
  5. Click "Import X Issues" to add them to your session

Troubleshooting

Connection Failed

  • Verify your Jira URL is correct (include https://)
  • Ensure your API token hasn't expired
  • Check that your email matches your Jira account

No Boards Available

  • Confirm you have access to at least one Scrum board
  • Verify that your project uses Scrum methodology (story points are not available in Kanban boards)
  • Check your Jira permissions for the project

Stories Not Loading

  • Ensure the sprint has stories assigned
  • Verify you have permission to view the issues
  • Try refreshing the connection

Still Having Trouble?

If you're still experiencing issues with the Jira integration, we're here to help! Reach out to us with your specific issue and we'll get back to you as soon as possible.

Security & Privacy

Your Jira credentials are stored securely and are only used to fetch story information. We never store your API token on our servers - it remains in your browser's local session. The connection is established securely from our backend servers to Jira's API using HTTPS protocols. Your browser communicates with our secure backend, which then proxies requests to Jira on your behalf.