(If you prefer to read this guide in German, please click here)
Note: Adding a JIRA integration to your Timeular account requires two main steps:
- Updating your JIRA account directly, and;
- Updating your Timeular account from https://profile.timeular.com
- Please start by going to your JIRA instance
- In your JIRA instance, go to “Jira settings/Products/Application links” (Note: Only JIRA users with administrator privileges can do this.)
- Create a new link for Timeular with the URL https://profile.timeular.com
(You may encounter this message after clicking the "Create new link" button. Click "Continue" if it appears)
4. In this form, please only enter the application name (Timeular), make sure to check “Create incoming link”, and hit "Continue". (Just those two fields are required here.)
5. Copy and paste your consumer and public key displayed on the Jira integration page on https://profile.timeular.com in here and enter a Consumer Name of your choosing which Atlassian describes as "A short name for the consumer site, to help users identify the consumer when granting it access to data." and click "Confirm".
6. Head back to https://profile.timeular.com to finish setting up the integration.
7. Enter your JIRA URL (e.g. https://YOURAWESOMECOMPANY.atlassian.net/) and click “Test Authentication” to ensure your integration is available to add. (You will not be able to move on to the next step unless this test passes.)
8. When your authentication test passes, click “Authorize” at the bottom of the page. You will be redirected to JIRA to confirm your authorization for Timeular to access your projects. Click “Allow” to be redirected back to Timeular.
9. Once you are redirected back, you will be asked to select your default project lead and project type and submit these options.
10. On the next page, please select which projects you would like to import to Timeular. These projects will be available as “activities” in the Timeular desktop and mobile apps.
(Note: You will be able to import more projects once your integration is complete if you change your mind at a later time.)
The following step is optional. If you don't configure webhooks, changes that you make to the worklog inside JIRA will NOT be synced back to Timeular.
11. As a final step, you may configure four webhooks from your JIRA instance at https://YOURAWESOMECOMPANY.atlassian.net/plugins/servlet/webhooks for the following events:
- Worklog created
- Worklog deleted
- Project created
- Project deleted
You're all set now.
For more information on how to use the JIRA integration inside the Timeular Apps please head over to https://support.timeular.com/integrations/jira
Any questions or feedback? Reach out via [email protected] or use the chat box on the bottom right corner of this page.