Action: Create Merge Request

GitLab Operation

The Create Merge Request action proposes changes by creating a merge request to combine code from one branch into another.

Example User Story

I want to submit my completed feature branch for review so the team can approve and merge it into the main codebase.

Fields

Field Name	Field Type	Required
projectId	Integer	Yes
sourceBranch	String	Yes
targetBranch	String	Yes
title	String	Yes
description	String	No
assigneeId	Integer	No

Related Connections

GitLab

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-merge-request",
  "state": "inDev",
  "meta": {
    "short": "Create Merge Request",
    "description": "Creates a new merge request in a GitLab project."
  },
  "input": [
    {
      "name": "projectId",
      "type": "Integer",
      "required": true,
      "meta": {
        "description": "The ID of the project where the merge request will be created."
      }
    },
    {
      "name": "sourceBranch",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The source branch for the merge request."
      }
    },
    {
      "name": "targetBranch",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The target branch for the merge request."
      }
    },
    {
      "name": "title",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The title of the merge request."
      }
    },
    {
      "name": "description",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The description of the merge request."
      }
    },
    {
      "name": "assigneeId",
      "type": "Integer",
      "required": false,
      "meta": {
        "description": "The ID of the user to assign the merge request to."
      }
    }
  ],
  "output": [
    {
      "name": "mergeRequest",
      "type": "Object",
      "selector": ["iid"],
      "meta": {
        "description": "The internal ID of the created merge request."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/projects/{{projectId}}/merge_requests",
        "headers": {
          "Content-Type": "application/json",
          "PRIVATE-TOKEN": "{{.accessToken}}"
        },
        "bodyTemplate": {
          "value": "{\"source_branch\":\"{{sourceBranch}}\",\"target_branch\":\"{{targetBranch}}\",\"title\":\"{{title}}\",\"description\":\"{{description}}\",\"assignee_id\":{{assigneeId}}}",
          "placeholders": [
            {
              "name": "sourceBranch",
              "type": "String",
              "description": "The source branch for the merge request.",
              "required": true
            },
            {
              "name": "targetBranch",
              "type": "String",
              "description": "The target branch for the merge request.",
              "required": true
            },
            {
              "name": "title",
              "type": "String",
              "description": "The title of the merge request.",
              "required": true
            },
            {
              "name": "description",
              "type": "String",
              "description": "The description of the merge request.",
              "required": false
            },
            {
              "name": "assigneeId",
              "type": "Integer",
              "description": "The ID of the user to assign the merge request to.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}