Jira Integration
Connect your Jira Cloud account to import issues, sync statuses, and manage work from Sunsama.
Bring your Jira issues into your daily plan. Browse issues with your Jira filters in a panel beside your task list, drag in what you’ll work on today, and move the issue along without leaving Sunsama.
Installation
- Go to Settings > Integrations > Jira, or open Jira in the right hand panel.
- Click Add Jira account and grant the requested permissions.
- If your Atlassian account has multiple sites, select which one to integrate.
You can connect more than one Jira account or site by repeating these steps.
The same settings page has a Show prompt to change status? toggle (see Status syncing) and an Include your activity from this tool in your Daily Highlights? toggle. Each account has a Remove button, plus Reconnect if Sunsama lost access, or Update when newer Jira features need fresh permission.
If the page says Reconnection required, click Reconnect Jira. Jira’s API changed, so workspaces you connected before need a one time reauthorization. If Atlassian then says your site admin must authorize the app, see below.
Browsing and importing issues
Open Jira in the right hand panel (keyboard shortcut Shift J). If you’ve connected more than one account or site, switch between them from the account picker at the top of the panel.
Finding issues
- Project: choose one project, or All Projects.
- Filter: pick a preset like My open issues, Reported by me, Watched by me or Current Sprint, or one of your Favorite filters. To add your own, save a filter in Jira and mark it as a favorite.
- Search: type in Search by title or JQL… to search by title or run a JQL query.
By default, issues you’ve already imported are hidden from the panel. Click Imported: Hide to switch it to Imported: Show.
Importing issues
When you’re ready to work on a Jira issue, pull it into your plan:
- Drag the card from the Jira panel onto your task list.
- To timebox it right away, switch to calendar view (
J) and drag the card onto your calendar at the time you’ll work on it. - Click the card and choose Add to today (or hover and press
S), or pick another date.
The Jira due date is copied to the Sunsama due date, and the issue’s remaining time estimate becomes the task’s planned time. Both are copied once, when you import, and don’t sync afterwards. The day the task shows on in Sunsama is the day you import it to.
You can import the same Jira issue more than once, with different titles, to track separate pieces of work on it.
Working with imported tasks
An imported Jira issue becomes a Sunsama task linked to the original. Click the Jira icon on the task (or hover and press G) to open it in Jira.
Editing the Jira issue from Sunsama
Open the Sunsama task to see the Jira issue inside it, with its details, subtasks, comments and history. Changes you make there are saved straight to Jira. You can:
- Move the issue to another status
- Assign it to yourself, or unassign it
- Change the priority, due date and start date
- Post a comment
Other fields, like labels, components and the description, are changed in Jira. If your Jira permissions don’t allow a change, the preview says so.
The Sunsama task works like a worksheet for the Jira issue. Add notes, subtasks, time tracking and comments there without touching what your collaborators see in Jira.
Status syncing
When you import or complete a Jira task, Sunsama asks whether you’d like to change the issue’s status in Jira. To stop the prompt, turn off Show prompt to change status? in Settings > Integrations > Jira.
Completing the Sunsama task doesn’t change the Jira issue unless you pick a status in that prompt.
Sunny and Autoplan
Sunny can read your Jira issues when you ask about them, for example “what’s in my current sprint?”. Autoplan also looks at Jira when it drafts your day. To stop Autoplan from using Jira, open Integrations on the daily planning screen and turn Jira off.
“Your site admin must authorize this app”
If Atlassian shows this message instead of the approval screen, your organization blocks members from connecting third-party apps on their own. An Atlassian admin has to allow it once.
This can happen even if you used the Jira integration before. Sunsama connects through a new Atlassian app, and Atlassian treats it as a separate app from the one you previously approved.
Ask an admin of your Atlassian organization to:
- Go to admin.atlassian.com and select your organization.
- Open Apps, select your site, then open Connected apps.
- Under Settings, set user-installed apps to Allowed.
Atlassian’s own guide is Manage your users’ third-party apps.
Troubleshooting
If Jira loads correctly in one app (desktop or web) but not both, try:
- Remove your Jira account from Sunsama
- Log out of all sessions
- Sign back in
- Reconnect your account
Contact support if the issue persists.