How to sync GitHub milestones with Jira sprints with Pipedream

Pipedream Dashboard > New Workflow

Create new Pipedream workflow

Go to pipedream.com and click New Workflow in your dashboard. You'll see a blank workflow canvas with a trigger step placeholder. This workflow will listen for GitHub milestone events and create corresponding Jira tickets when issues are added.

1. 1Click the 'New Workflow' button on your dashboard
2. 2Click the trigger step placeholder that says 'Select a trigger'
3. 3Search for 'GitHub' in the app list
4. 4Select 'GitHub' from the results

Workflow > Trigger Step > GitHub > New Milestone Event

Configure GitHub milestone webhook

Select the 'New Milestone Event' source from GitHub's trigger options. This fires whenever milestone events occur in your repository. You'll need to connect your GitHub account and specify which repository to monitor for milestone changes.

1. 1Choose 'New Milestone Event' from the trigger list
2. 2Click 'Connect GitHub' to authenticate
3. 3Select your target repository from the dropdown
4. 4Choose 'Issues' in the events filter

Trigger Step > Connect Account > GitHub

Add GitHub authentication

Pipedream will prompt you to authenticate with GitHub. Click the authentication button and authorize Pipedream to access your repositories. Make sure you grant access to the specific organization or repository where your milestones live.

1. 1Click 'Connect a new account' in the auth section
2. 2Select required scopes: repo, read:org
3. 3Click 'Authorize Pipedream' in GitHub
4. 4Return to Pipedream and confirm connection

Workflow > + Add Step > Filter

Add filter for issue additions

Click the plus button below your trigger to add a new step. Search for 'Filter' and add a Filter step. This prevents the workflow from running on milestone events that aren't about adding issues - like milestone creation or closing.

1. 1Click the + button below the GitHub trigger
2. 2Search for 'Filter' in the step library
3. 3Select the 'Filter' step type
4. 4Name it 'Filter for issue additions'

Filter Step > Condition Configuration

Configure issue addition filter

Set up the filter condition to only continue when issues are added to milestones. The GitHub webhook sends different action types - you want to filter for when action equals 'milestoned' and the issue object exists in the payload.

1. 1Set condition to 'Equal'
2. 2In left field, select steps.trigger.event.action
3. 3In right field, type 'milestoned'
4. 4Click 'Continue' to save the filter

Workflow > + Add Step > Code

Add Node.js code step for data preparation

Add a Code step to extract and format the GitHub issue data before sending to Jira. This step will grab the issue title, description, labels, and milestone name from the GitHub webhook payload and prepare them for Jira's expected format.

1. 1Click + below the Filter step
2. 2Search for 'Node.js' in the step library
3. 3Select 'Run Node.js code'
4. 4Name the step 'Prepare Jira data'

This Node.js code goes in the data preparation step to extract GitHub issue data and format it for Jira. Paste it into the code editor and update the project key to match your Jira project.

export default defineComponent({
  async run({ steps, $ }) {
    const { issue, milestone, repository } = steps.trigger.event;

export default defineComponent({
  async run({ steps, $ }) {
    const { issue, milestone, repository } = steps.trigger.event;
    
    // Prevent processing if issue doesn't exist
    if (!issue || !milestone) {
      $.flow.exit('No issue or milestone data in event');
      return;
    }
    
    // Convert GitHub markdown to Jira markup
    const convertMarkdown = (text) => {
      if (!text) return '';
      return text
        .replace(/\*\*(.*?)\*\*/g, '*$1*')  // Bold
        .replace(/\*(.*?)\*/g, '_$1_')     // Italic
        .replace(/([\s\S]*?)/g, '{code}$1{code}')  // Code blocks
        .replace(/`(.*?)`/g, '{{$1}}');   // Inline code
    };
    
    // Extract labels and convert to Jira format
    const labels = issue.labels?.map(label => label.name) || [];
    
    // Prepare Jira ticket data
    const jiraData = {
      summary: issue.title,
      description: convertMarkdown(issue.body),
      labels: labels,
      milestone: milestone.title,
      githubUrl: issue.html_url,
      githubNumber: issue.number,
      creator: issue.user?.login,
      repository: repository.name,
      projectKey: 'YOUR_PROJECT_KEY'  // Update this
    };
    
    // Return data for next step
    return jiraData;
  }
});

Code Step > Editor

Write data transformation code

Replace the template code with logic to extract GitHub issue data and format it for Jira. The code will access the webhook payload from previous steps and structure it as a Jira ticket object with proper field mapping.

1. 1Clear the existing template code
2. 2Paste the data transformation code from the pro tip section
3. 3Update the Jira project key to match your project
4. 4Test the step to verify data extraction

This Node.js code goes in the data preparation step to extract GitHub issue data and format it for Jira. Paste it into the code editor and update the project key to match your Jira project.

export default defineComponent({
  async run({ steps, $ }) {
    const { issue, milestone, repository } = steps.trigger.event;

export default defineComponent({
  async run({ steps, $ }) {
    const { issue, milestone, repository } = steps.trigger.event;
    
    // Prevent processing if issue doesn't exist
    if (!issue || !milestone) {
      $.flow.exit('No issue or milestone data in event');
      return;
    }
    
    // Convert GitHub markdown to Jira markup
    const convertMarkdown = (text) => {
      if (!text) return '';
      return text
        .replace(/\*\*(.*?)\*\*/g, '*$1*')  // Bold
        .replace(/\*(.*?)\*/g, '_$1_')     // Italic
        .replace(/([\s\S]*?)/g, '{code}$1{code}')  // Code blocks
        .replace(/`(.*?)`/g, '{{$1}}');   // Inline code
    };
    
    // Extract labels and convert to Jira format
    const labels = issue.labels?.map(label => label.name) || [];
    
    // Prepare Jira ticket data
    const jiraData = {
      summary: issue.title,
      description: convertMarkdown(issue.body),
      labels: labels,
      milestone: milestone.title,
      githubUrl: issue.html_url,
      githubNumber: issue.number,
      creator: issue.user?.login,
      repository: repository.name,
      projectKey: 'YOUR_PROJECT_KEY'  // Update this
    };
    
    // Return data for next step
    return jiraData;
  }
});

Workflow > + Add Step > Jira > Create Issue

Add Jira connection step

Add a new Jira step to create the ticket. Click the plus button and search for Jira, then select the 'Create Issue' action. This will prompt you to authenticate with your Jira instance and configure the ticket creation parameters.

1. 1Click + below the code step
2. 2Search for 'Jira' and select it
3. 3Choose 'Create Issue' from actions
4. 4Click 'Connect Jira' to authenticate

Jira Step > Authentication

Authenticate Jira connection

Connect your Jira account by providing your Jira domain and API credentials. For Jira Cloud, you'll need an API token from your Atlassian account. For Jira Server, use your username and password or API token depending on your configuration.

1. 1Select 'Jira Cloud' or 'Jira Server'
2. 2Enter your Jira domain (yourcompany.atlassian.net)
3. 3Provide email and API token for authentication
4. 4Test the connection

Jira Step > Create Issue Configuration

Configure Jira ticket creation

Map the prepared data from your code step to Jira ticket fields. Select your target project and issue type, then map the summary, description, and other fields using the data prepared in the previous code step.

1. 1Select your target project from the dropdown
2. 2Choose issue type (usually 'Story' or 'Task')
3. 3Map Summary field to steps.prepare_jira_data.summary
4. 4Map Description to steps.prepare_jira_data.description
5. 5Set any required custom fields for your project

Workflow > Save > Test

Test and deploy the workflow

Save your workflow and test it with a real GitHub milestone event. Add an issue to a milestone in your connected repository to trigger the workflow. Check both the Pipedream execution logs and your Jira project to confirm the ticket was created correctly.

1. 1Click 'Save' in the top right
2. 2Go to your GitHub repository
3. 3Add an issue to any milestone
4. 4Return to Pipedream and check execution history
5. 5Verify the Jira ticket was created