This automation rule will create a Roadmap Item on your LaunchNotes account when you create an Epic (or whatever issue you'd like to use), in Jira. In order to set this up, you'll need the following information from your LaunchNotes account:

  1. Your project ID

  2. Your management API token

  3. Your preferred starting stage ID


Jira Setup

In Jira, go to Project Settings > Apps > Project automation > Rules > Create rule:

  • New Trigger: When: Issue created

  • New condition: Issue fields condition

    • Field: Issue Type

    • Condition: Equals

    • Value: Epic

  • Add Component:

New action: Send web request

{
"query":"mutation createWorkItem (\n $name: String!\n $stageId: ID!\n $categories: [CategoryAttributes!]\n $contentJira: String\n) {\n createWorkItem(input: {\n workItem: {\n name: $name,\n stageId: $stageId,\n categories: $categories,\n contentJira: $contentJira\n }\n}){\n workItem {\n id\n}\n}\n}",
"variables":{
"projectId":"YOUR_PROJECT_ID",
"name":"{{issue.summary.jsonEncode}}",
"contentJira":"{{issue.description.jsonEncode}}",
"stageId":"YOUR_STAGE_ID"
}
}

  • Select Wait for response ✅ "Delay execution of subsequent rule actions until we've received a response for this webhook"

Now this is set up, the next step is to identify and attach the LaunchNotes roadmap work item ID to your Epic, once it has been created in LaunchNotes created via the Jira Automation.

Continue adding to the rule:

Test this out by creating a New Epic in Jira. Now when this is saved out, the field launch_notes_work_item_id should be populated with the LaunchNotes roadmap work item ID:

❓ If you have any questions on our Jira integration, or would like suggest any changes to this help article please don't hesitate to get in touch with us at hey@launchnotes.io, or join us on live chat.

Did this answer your question?