1--- 2stage: Ecosystem 3group: Integrations 4info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments 5--- 6 7# Integrations API **(FREE)** 8 9This API enables you to work with external services that integrate with GitLab. 10 11NOTE: 12In GitLab 14.4, the `services` endpoint was [renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/334500) to `integrations`. 13Calls to the Integrations API can be made to both `/projects/:id/services` and `/projects/:id/integrations`. 14The examples in this document refer to the endpoint at `/projects/:id/integrations`. 15 16This API requires an access token with the [Maintainer or Owner role](../user/permissions.md). 17 18## List all active integrations 19 20> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/21330) in GitLab 12.7. 21 22Get a list of all active project integrations. 23 24```plaintext 25GET /projects/:id/integrations 26``` 27 28Example response: 29 30```json 31[ 32 { 33 "id": 75, 34 "title": "Jenkins CI", 35 "slug": "jenkins", 36 "created_at": "2019-11-20T11:20:25.297Z", 37 "updated_at": "2019-11-20T12:24:37.498Z", 38 "active": true, 39 "commit_events": true, 40 "push_events": true, 41 "issues_events": true, 42 "confidential_issues_events": true, 43 "merge_requests_events": true, 44 "tag_push_events": false, 45 "note_events": true, 46 "confidential_note_events": true, 47 "pipeline_events": true, 48 "wiki_page_events": true, 49 "job_events": true, 50 "comment_on_event_enabled": true 51 }, 52 { 53 "id": 76, 54 "title": "Alerts endpoint", 55 "slug": "alerts", 56 "created_at": "2019-11-20T11:20:25.297Z", 57 "updated_at": "2019-11-20T12:24:37.498Z", 58 "active": true, 59 "commit_events": true, 60 "push_events": true, 61 "issues_events": true, 62 "confidential_issues_events": true, 63 "merge_requests_events": true, 64 "tag_push_events": true, 65 "note_events": true, 66 "confidential_note_events": true, 67 "pipeline_events": true, 68 "wiki_page_events": true, 69 "job_events": true, 70 "comment_on_event_enabled": true 71 } 72] 73``` 74 75## Asana 76 77Add commit messages as comments to Asana tasks. 78 79See also the [Asana integration documentation](../user/project/integrations/asana.md). 80 81### Create/Edit Asana integration 82 83Set Asana integration for a project. 84 85```plaintext 86PUT /projects/:id/integrations/asana 87``` 88 89Parameters: 90 91| Parameter | Type | Required | Description | 92| --------- | ---- | -------- | ----------- | 93| `api_key` | string | true | User API token. User must have access to task. All comments are attributed to this user. | 94| `restrict_to_branch` | string | false | Comma-separated list of branches to be are automatically inspected. Leave blank to include all branches. | 95| `push_events` | boolean | false | Enable notifications for push events | 96 97### Disable Asana integration 98 99Disable the Asana integration for a project. Integration settings are preserved. 100 101```plaintext 102DELETE /projects/:id/integrations/asana 103``` 104 105### Get Asana integration settings 106 107Get Asana integration settings for a project. 108 109```plaintext 110GET /projects/:id/integrations/asana 111``` 112 113## Assembla 114 115Project Management Software (Source Commits Endpoint) 116 117### Create/Edit Assembla integration 118 119Set Assembla integration for a project. 120 121```plaintext 122PUT /projects/:id/integrations/assembla 123``` 124 125Parameters: 126 127| Parameter | Type | Required | Description | 128| --------- | ---- | -------- | ----------- | 129| `token` | string | true | The authentication token 130| `subdomain` | string | false | The subdomain setting | 131| `push_events` | boolean | false | Enable notifications for push events | 132 133### Disable Assembla integration 134 135Disable the Assembla integration for a project. Integration settings are preserved. 136 137```plaintext 138DELETE /projects/:id/integrations/assembla 139``` 140 141### Get Assembla integration settings 142 143Get Assembla integration settings for a project. 144 145```plaintext 146GET /projects/:id/integrations/assembla 147``` 148 149## Atlassian Bamboo CI 150 151A continuous integration and build server 152 153### Create/Edit Atlassian Bamboo CI integration 154 155Set Atlassian Bamboo CI integration for a project. 156 157> You must set up automatic revision labeling and a repository trigger in Bamboo. 158 159```plaintext 160PUT /projects/:id/integrations/bamboo 161``` 162 163Parameters: 164 165| Parameter | Type | Required | Description | 166| --------- | ---- | -------- | ----------- | 167| `bamboo_url` | string | true | Bamboo root URL. For example, `https://bamboo.example.com`. | 168| `build_key` | string | true | Bamboo build plan key like KEY | 169| `username` | string | true | A user with API access, if applicable | 170| `password` | string | true | Password of the user | 171| `push_events` | boolean | false | Enable notifications for push events | 172 173### Disable Atlassian Bamboo CI integration 174 175Disable the Atlassian Bamboo CI integration for a project. Integration settings are preserved. 176 177```plaintext 178DELETE /projects/:id/integrations/bamboo 179``` 180 181### Get Atlassian Bamboo CI integration settings 182 183Get Atlassian Bamboo CI integration settings for a project. 184 185```plaintext 186GET /projects/:id/integrations/bamboo 187``` 188 189## Bugzilla 190 191Bugzilla Issue Tracker 192 193### Create/Edit Bugzilla integration 194 195Set Bugzilla integration for a project. 196 197```plaintext 198PUT /projects/:id/integrations/bugzilla 199``` 200 201Parameters: 202 203| Parameter | Type | Required | Description | 204| --------- | ---- | -------- | ----------- | 205| `new_issue_url` | string | true | New Issue URL | 206| `issues_url` | string | true | Issue URL | 207| `project_url` | string | true | Project URL | 208| `description` | string | false | Description | 209| `title` | string | false | Title | 210| `push_events` | boolean | false | Enable notifications for push events | 211 212### Disable Bugzilla integration 213 214Disable the Bugzilla integration for a project. Integration settings are preserved. 215 216```plaintext 217DELETE /projects/:id/integrations/bugzilla 218``` 219 220### Get Bugzilla integration settings 221 222Get Bugzilla integration settings for a project. 223 224```plaintext 225GET /projects/:id/integrations/bugzilla 226``` 227 228## Buildkite 229 230Continuous integration and deployments 231 232### Create/Edit Buildkite integration 233 234Set Buildkite integration for a project. 235 236```plaintext 237PUT /projects/:id/integrations/buildkite 238``` 239 240Parameters: 241 242| Parameter | Type | Required | Description | 243| --------- | ---- | -------- | ----------- | 244| `token` | string | true | Buildkite project GitLab token | 245| `project_url` | string | true | Pipeline URL. For example, `https://buildkite.com/example/pipeline` | 246| `enable_ssl_verification` | boolean | false | DEPRECATED: This parameter has no effect since SSL verification is always enabled | 247| `push_events` | boolean | false | Enable notifications for push events | 248 249### Disable Buildkite integration 250 251Disable the Buildkite integration for a project. Integration settings are preserved. 252 253```plaintext 254DELETE /projects/:id/integrations/buildkite 255``` 256 257### Get Buildkite integration settings 258 259Get Buildkite integration settings for a project. 260 261```plaintext 262GET /projects/:id/integrations/buildkite 263``` 264 265## Campfire 266 267Send notifications about push events to Campfire chat rooms. 268[New users can no longer sign up for Campfire](https://basecamp.com/retired/campfire). 269 270### Create/Edit Campfire integration 271 272Set Campfire integration for a project. 273 274```plaintext 275PUT /projects/:id/integrations/campfire 276``` 277 278Parameters: 279 280| Parameter | Type | Required | Description | 281|---------------|---------|----------|---------------------------------------------------------------------------------------------| 282| `token` | string | true | Campfire API token. To find it, log into Campfire and select **My info**. | 283| `subdomain` | string | false | Campfire subdomain. Text between `https://` and `.campfirenow.com` when you're logged in. | 284| `room` | string | false | Campfire room. The last part of the URL when you're in a room. | 285| `push_events` | boolean | false | Enable notifications for push events. | 286 287### Disable Campfire integration 288 289Disable the Campfire integration for a project. Integration settings are preserved. 290 291```plaintext 292DELETE /projects/:id/integrations/campfire 293``` 294 295### Get Campfire integration settings 296 297Get Campfire integration settings for a project. 298 299```plaintext 300GET /projects/:id/integrations/campfire 301``` 302 303## Datadog 304 305Datadog system monitoring. 306 307### Create/Edit Datadog integration 308 309Set Datadog integration for a project. 310 311```plaintext 312PUT /projects/:id/integrations/datadog 313``` 314 315Parameters: 316 317| Parameter | Type | Required | Description | 318| --------- | ---- | -------- | ----------- | 319| `api_key` | string | true | API key used for authentication with Datadog | 320| `api_url` | string | false | (Advanced) Define the full URL for your Datadog site directly | 321| `datadog_site` | string | false | Choose the Datadog site to send data to. Set to `datadoghq.eu` to send data to the EU site | 322| `datadog_service` | string | false | Name of this GitLab instance that all data will be tagged with | 323| `datadog_env` | string | false | The environment tag that traces will be tagged with | 324 325### Disable Datadog integration 326 327Disable the Datadog integration for a project. Integration settings are preserved. 328 329```plaintext 330DELETE /projects/:id/integrations/datadog 331``` 332 333### Get Datadog integration settings 334 335Get Datadog integration settings for a project. 336 337```plaintext 338GET /projects/:id/integrations/datadog 339``` 340 341## Unify Circuit 342 343Unify Circuit RTC and collaboration tool. 344 345### Create/Edit Unify Circuit integration 346 347Set Unify Circuit integration for a project. 348 349```plaintext 350PUT /projects/:id/integrations/unify-circuit 351``` 352 353Parameters: 354 355| Parameter | Type | Required | Description | 356| --------- | ---- | -------- | ----------- | 357| `webhook` | string | true | The Unify Circuit webhook. For example, `https://circuit.com/rest/v2/webhooks/incoming/...`. | 358| `notify_only_broken_pipelines` | boolean | false | Send notifications for broken pipelines | 359| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected". The default value is "default" | 360| `push_events` | boolean | false | Enable notifications for push events | 361| `issues_events` | boolean | false | Enable notifications for issue events | 362| `confidential_issues_events` | boolean | false | Enable notifications for confidential issue events | 363| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 364| `tag_push_events` | boolean | false | Enable notifications for tag push events | 365| `note_events` | boolean | false | Enable notifications for note events | 366| `confidential_note_events` | boolean | false | Enable notifications for confidential note events | 367| `pipeline_events` | boolean | false | Enable notifications for pipeline events | 368| `wiki_page_events` | boolean | false | Enable notifications for wiki page events | 369 370### Disable Unify Circuit integration 371 372Disable the Unify Circuit integration for a project. Integration settings are preserved. 373 374```plaintext 375DELETE /projects/:id/integrations/unify-circuit 376``` 377 378### Get Unify Circuit integration settings 379 380Get Unify Circuit integration settings for a project. 381 382```plaintext 383GET /projects/:id/integrations/unify-circuit 384``` 385 386## Webex Teams 387 388Webex Teams collaboration tool. 389 390### Create/Edit Webex Teams integration 391 392Set Webex Teams integration for a project. 393 394```plaintext 395PUT /projects/:id/integrations/webex-teams 396``` 397 398Parameters: 399 400| Parameter | Type | Required | Description | 401| --------- | ---- | -------- | ----------- | 402| `webhook` | string | true | The Webex Teams webhook. For example, `https://api.ciscospark.com/v1/webhooks/incoming/...`. | 403| `notify_only_broken_pipelines` | boolean | false | Send notifications for broken pipelines | 404| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected". The default value is "default" | 405| `push_events` | boolean | false | Enable notifications for push events | 406| `issues_events` | boolean | false | Enable notifications for issue events | 407| `confidential_issues_events` | boolean | false | Enable notifications for confidential issue events | 408| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 409| `tag_push_events` | boolean | false | Enable notifications for tag push events | 410| `note_events` | boolean | false | Enable notifications for note events | 411| `confidential_note_events` | boolean | false | Enable notifications for confidential note events | 412| `pipeline_events` | boolean | false | Enable notifications for pipeline events | 413| `wiki_page_events` | boolean | false | Enable notifications for wiki page events | 414 415### Disable Webex Teams integration 416 417Disable the Webex Teams integration for a project. Integration settings are preserved. 418 419```plaintext 420DELETE /projects/:id/integrations/webex-teams 421``` 422 423### Get Webex Teams integration settings 424 425Get Webex Teams integration settings for a project. 426 427```plaintext 428GET /projects/:id/integrations/webex-teams 429``` 430 431## Custom Issue Tracker 432 433Custom issue tracker 434 435### Create/Edit Custom Issue Tracker integration 436 437Set Custom Issue Tracker integration for a project. 438 439```plaintext 440PUT /projects/:id/integrations/custom-issue-tracker 441``` 442 443Parameters: 444 445| Parameter | Type | Required | Description | 446| --------- | ---- | -------- | ----------- | 447| `new_issue_url` | string | true | New Issue URL | 448| `issues_url` | string | true | Issue URL | 449| `project_url` | string | true | Project URL | 450| `description` | string | false | Description | 451| `title` | string | false | Title | 452| `push_events` | boolean | false | Enable notifications for push events | 453 454### Disable Custom Issue Tracker integration 455 456Disable the Custom Issue Tracker integration for a project. Integration settings are preserved. 457 458```plaintext 459DELETE /projects/:id/integrations/custom-issue-tracker 460``` 461 462### Get Custom Issue Tracker integration settings 463 464Get Custom Issue Tracker integration settings for a project. 465 466```plaintext 467GET /projects/:id/integrations/custom-issue-tracker 468``` 469 470## Discord 471 472Send notifications about project events to a Discord channel. 473 474### Create/Edit Discord integration 475 476Set Discord integration for a project. 477 478```plaintext 479PUT /projects/:id/integrations/discord 480``` 481 482Parameters: 483 484| Parameter | Type | Required | Description | 485| --------- | ---- | -------- | ----------- | 486| `webhook` | string | true | Discord webhook. For example, `https://discord.com/api/webhooks/…` | 487 488### Disable Discord integration 489 490Disable the Discord integration for a project. Integration settings are preserved. 491 492```plaintext 493DELETE /projects/:id/integrations/discord 494``` 495 496### Get Discord integration settings 497 498Get Discord integration settings for a project. 499 500```plaintext 501GET /projects/:id/integrations/discord 502``` 503 504## Drone CI 505 506Drone is a Continuous Integration platform built on Docker, written in Go 507 508### Create/Edit Drone CI integration 509 510Set Drone CI integration for a project. 511 512```plaintext 513PUT /projects/:id/integrations/drone-ci 514``` 515 516Parameters: 517 518| Parameter | Type | Required | Description | 519| --------- | ---- | -------- | ----------- | 520| `token` | string | true | Drone CI project specific token | 521| `drone_url` | string | true | `http://drone.example.com` | 522| `enable_ssl_verification` | boolean | false | Enable SSL verification | 523| `push_events` | boolean | false | Enable notifications for push events | 524| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 525| `tag_push_events` | boolean | false | Enable notifications for tag push events | 526 527### Disable Drone CI integration 528 529Disable the Drone CI integration for a project. Integration settings are preserved. 530 531```plaintext 532DELETE /projects/:id/integrations/drone-ci 533``` 534 535### Get Drone CI integration settings 536 537Get Drone CI integration settings for a project. 538 539```plaintext 540GET /projects/:id/integrations/drone-ci 541``` 542 543## Emails on Push 544 545Email the commits and diff of each push to a list of recipients. 546 547### Create/Edit Emails on Push integration 548 549Set Emails on Push integration for a project. 550 551```plaintext 552PUT /projects/:id/integrations/emails-on-push 553``` 554 555Parameters: 556 557| Parameter | Type | Required | Description | 558| --------- | ---- | -------- | ----------- | 559| `recipients` | string | true | Emails separated by whitespace | 560| `disable_diffs` | boolean | false | Disable code diffs | 561| `send_from_committer_email` | boolean | false | Send from committer | 562| `push_events` | boolean | false | Enable notifications for push events | 563| `tag_push_events` | boolean | false | Enable notifications for tag push events | 564| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected". Notifications are always fired for tag pushes. The default value is "all" | 565 566### Disable Emails on Push integration 567 568Disable the Emails on Push integration for a project. Integration settings are preserved. 569 570```plaintext 571DELETE /projects/:id/integrations/emails-on-push 572``` 573 574### Get Emails on Push integration settings 575 576Get Emails on Push integration settings for a project. 577 578```plaintext 579GET /projects/:id/integrations/emails-on-push 580``` 581 582## Engineering Workflow Management (EWM) 583 584Use IBM Engineering Workflow Management (EWM) as a project's issue tracker. 585 586### Create/Edit EWM integration 587 588Set EWM integration for a project. 589 590```plaintext 591PUT /projects/:id/integrations/ewm 592``` 593 594Parameters: 595 596| Parameter | Type | Required | Description | 597| --------- | ---- | -------- | ----------- | 598| `new_issue_url` | string | true | The URL to create an issue in EWM | 599| `project_url` | string | true | The URL to the project in EWM | 600| `issues_url` | string | true | The URL to view an issue in EWM. Must contain `:id` | 601 602### Disable EWM integration 603 604Disable the EWM integration for a project. Integration settings are preserved. 605 606```plaintext 607DELETE /projects/:id/integrations/ewm 608``` 609 610### Get EWM integration settings 611 612Get EWM integration settings for a project. 613 614```plaintext 615GET /projects/:id/integrations/ewm 616``` 617 618## Confluence integration 619 620> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/220934) in GitLab 13.2. 621 622Replaces the link to the internal wiki with a link to a Confluence Cloud Workspace. 623 624### Create/Edit Confluence integration 625 626Set Confluence integration for a project. 627 628```plaintext 629PUT /projects/:id/integrations/confluence 630``` 631 632Parameters: 633 634| Parameter | Type | Required | Description | 635| --------- | ---- | -------- | ----------- | 636| `confluence_url` | string | true | The URL of the Confluence Cloud Workspace hosted on atlassian.net. | 637 638### Disable Confluence integration 639 640Disable the Confluence integration for a project. Integration settings are preserved. 641 642```plaintext 643DELETE /projects/:id/integrations/confluence 644``` 645 646### Get Confluence integration settings 647 648Get Confluence integration settings for a project. 649 650```plaintext 651GET /projects/:id/integrations/confluence 652``` 653 654## External wiki 655 656Replaces the link to the internal wiki with a link to an external wiki. 657 658### Create/Edit External wiki integration 659 660Set External wiki integration for a project. 661 662```plaintext 663PUT /projects/:id/integrations/external-wiki 664``` 665 666Parameters: 667 668| Parameter | Type | Required | Description | 669| --------- | ---- | -------- | ----------- | 670| `external_wiki_url` | string | true | The URL of the external wiki | 671 672### Disable External wiki integration 673 674Disable the External wiki integration for a project. Integration settings are preserved. 675 676```plaintext 677DELETE /projects/:id/integrations/external-wiki 678``` 679 680### Get External wiki integration settings 681 682Get External wiki integration settings for a project. 683 684```plaintext 685GET /projects/:id/integrations/external-wiki 686``` 687 688## Flowdock 689 690Flowdock is a ChatOps application for collaboration in software engineering 691companies. You can send notifications from GitLab events to Flowdock flows. 692For integration instructions, see the [Flowdock documentation](https://www.flowdock.com/help/gitlab). 693 694### Create/Edit Flowdock integration 695 696Set Flowdock integration for a project. 697 698```plaintext 699PUT /projects/:id/integrations/flowdock 700``` 701 702Parameters: 703 704| Parameter | Type | Required | Description | 705| --------- | ---- | -------- | ----------- | 706| `token` | string | true | Flowdock Git source token | 707| `push_events` | boolean | false | Enable notifications for push events | 708 709### Disable Flowdock integration 710 711Disable the Flowdock integration for a project. Integration settings are preserved. 712 713```plaintext 714DELETE /projects/:id/integrations/flowdock 715``` 716 717### Get Flowdock integration settings 718 719Get Flowdock integration settings for a project. 720 721```plaintext 722GET /projects/:id/integrations/flowdock 723``` 724 725## GitHub **(PREMIUM)** 726 727Code collaboration software. 728 729### Create/Edit GitHub integration 730 731Set GitHub integration for a project. 732 733```plaintext 734PUT /projects/:id/integrations/github 735``` 736 737Parameters: 738 739| Parameter | Type | Required | Description | 740| --------- | ---- | -------- | ----------- | 741| `token` | string | true | GitHub API token with `repo:status` OAuth scope | 742| `repository_url` | string | true | GitHub repository URL | 743| `static_context` | boolean | false | Append instance name instead of branch to [status check name](../user/project/integrations/github.md#static-or-dynamic-status-check-names) | 744 745### Disable GitHub integration 746 747Disable the GitHub integration for a project. Integration settings are preserved. 748 749```plaintext 750DELETE /projects/:id/integrations/github 751``` 752 753### Get GitHub integration settings 754 755Get GitHub integration settings for a project. 756 757```plaintext 758GET /projects/:id/integrations/github 759``` 760 761## Hangouts Chat 762 763Google Workspace team collaboration tool. 764 765### Create/Edit Hangouts Chat integration 766 767Set Hangouts Chat integration for a project. 768 769```plaintext 770PUT /projects/:id/integrations/hangouts-chat 771``` 772 773Parameters: 774 775| Parameter | Type | Required | Description | 776| --------- | ---- | -------- | ----------- | 777| `webhook` | string | true | The Hangouts Chat webhook. For example, `https://chat.googleapis.com/v1/spaces...`. | 778| `notify_only_broken_pipelines` | boolean | false | Send notifications for broken pipelines | 779| `notify_only_default_branch` | boolean | false | DEPRECATED: This parameter has been replaced with `branches_to_be_notified` | 780| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected". The default value is "default" | 781| `push_events` | boolean | false | Enable notifications for push events | 782| `issues_events` | boolean | false | Enable notifications for issue events | 783| `confidential_issues_events` | boolean | false | Enable notifications for confidential issue events | 784| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 785| `tag_push_events` | boolean | false | Enable notifications for tag push events | 786| `note_events` | boolean | false | Enable notifications for note events | 787| `confidential_note_events` | boolean | false | Enable notifications for confidential note events | 788| `pipeline_events` | boolean | false | Enable notifications for pipeline events | 789| `wiki_page_events` | boolean | false | Enable notifications for wiki page events | 790 791### Disable Hangouts Chat integration 792 793Disable the Hangouts Chat integration for a project. Integration settings are preserved. 794 795```plaintext 796DELETE /projects/:id/integrations/hangouts-chat 797``` 798 799### Get Hangouts Chat integration settings 800 801Get Hangouts Chat integration settings for a project. 802 803```plaintext 804GET /projects/:id/integrations/hangouts-chat 805``` 806 807## Irker (IRC gateway) 808 809Send IRC messages, on update, to a list of recipients through an irker gateway. 810 811For more information, see the [irker integration documentation](../user/project/integrations/irker.md). 812 813### Create/Edit Irker (IRC gateway) integration 814 815Set Irker (IRC gateway) integration for a project. 816 817```plaintext 818PUT /projects/:id/integrations/irker 819``` 820 821Parameters: 822 823| Parameter | Type | Required | Description | 824| --------- | ---- | -------- | ----------- | 825| `recipients` | string | true | Recipients/channels separated by whitespaces | 826| `default_irc_uri` | string | false | `irc://irc.network.net:6697/` | 827| `server_host` | string | false | localhost | 828| `server_port` | integer | false | 6659 | 829| `colorize_messages` | boolean | false | Colorize messages | 830| `push_events` | boolean | false | Enable notifications for push events | 831 832### Disable Irker (IRC gateway) integration 833 834Disable the Irker (IRC gateway) integration for a project. Integration settings are preserved. 835 836```plaintext 837DELETE /projects/:id/integrations/irker 838``` 839 840### Get Irker (IRC gateway) integration settings 841 842Get Irker (IRC gateway) integration settings for a project. 843 844```plaintext 845GET /projects/:id/integrations/irker 846``` 847 848## Jira 849 850Jira issue tracker. 851 852### Get Jira integration settings 853 854Get Jira integration settings for a project. 855 856```plaintext 857GET /projects/:id/integrations/jira 858``` 859 860### Create/Edit Jira integration 861 862Set Jira integration for a project. 863 864```plaintext 865PUT /projects/:id/integrations/jira 866``` 867 868Parameters: 869 870| Parameter | Type | Required | Description | 871| --------- | ---- | -------- | ----------- | 872| `url` | string | yes | The URL to the Jira project which is being linked to this GitLab project. For example, `https://jira.example.com`. | 873| `api_url` | string | no | The base URL to the Jira instance API. Web URL value is used if not set. For example, `https://jira-api.example.com`. | 874| `username` | string | yes | The username of the user created to be used with GitLab/Jira. | 875| `password` | string | yes | The password of the user created to be used with GitLab/Jira. | 876| `active` | boolean | no | Activates or deactivates the integration. Defaults to false (deactivated). | 877| `jira_issue_transition_automatic` | boolean | no | Enable [automatic issue transitions](../integration/jira/issues.md#automatic-issue-transitions). Takes precedence over `jira_issue_transition_id` if enabled. Defaults to `false` | 878| `jira_issue_transition_id` | string | no | The ID of one or more transitions for [custom issue transitions](../integration/jira/issues.md#custom-issue-transitions). Ignored if `jira_issue_transition_automatic` is enabled. Defaults to a blank string, which disables custom transitions. | 879| `commit_events` | boolean | false | Enable notifications for commit events | 880| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 881| `comment_on_event_enabled` | boolean | false | Enable comments inside Jira issues on each GitLab event (commit / merge request) | 882 883### Disable Jira integration 884 885Disable the Jira integration for a project. Integration settings are preserved. 886 887```plaintext 888DELETE /projects/:id/integrations/jira 889``` 890 891## Slack Slash Commands 892 893Ability to receive slash commands from a Slack chat instance. 894 895### Get Slack Slash Command integration settings 896 897Get Slack Slash Command integration settings for a project. 898 899```plaintext 900GET /projects/:id/integrations/slack-slash-commands 901``` 902 903Example response: 904 905```json 906{ 907 "id": 4, 908 "title": "Slack slash commands", 909 "slug": "slack-slash-commands", 910 "created_at": "2017-06-27T05:51:39-07:00", 911 "updated_at": "2017-06-27T05:51:39-07:00", 912 "active": true, 913 "push_events": true, 914 "issues_events": true, 915 "confidential_issues_events": true, 916 "merge_requests_events": true, 917 "tag_push_events": true, 918 "note_events": true, 919 "job_events": true, 920 "pipeline_events": true, 921 "comment_on_event_enabled": false, 922 "properties": { 923 "token": "<your_access_token>" 924 } 925} 926``` 927 928### Create/Edit Slack Slash Commands integration 929 930Set Slack Slash Command for a project. 931 932```plaintext 933PUT /projects/:id/integrations/slack-slash-commands 934``` 935 936Parameters: 937 938| Parameter | Type | Required | Description | 939| --------- | ---- | -------- | ----------- | 940| `token` | string | yes | The Slack token | 941 942### Disable Slack Slash Command integration 943 944Disable the Slack Slash Command integration for a project. Integration settings are preserved. 945 946```plaintext 947DELETE /projects/:id/integrations/slack-slash-commands 948``` 949 950## Mattermost Slash Commands 951 952Ability to receive slash commands from a Mattermost chat instance. 953 954### Get Mattermost Slash Command integration settings 955 956Get Mattermost Slash Command integration settings for a project. 957 958```plaintext 959GET /projects/:id/integrations/mattermost-slash-commands 960``` 961 962### Create/Edit Mattermost Slash Command integration 963 964Set Mattermost Slash Command for a project. 965 966```plaintext 967PUT /projects/:id/integrations/mattermost-slash-commands 968``` 969 970Parameters: 971 972| Parameter | Type | Required | Description | 973| --------- | ---- | -------- | ----------- | 974| `token` | string | yes | The Mattermost token | 975| `username` | string | no | The username to use to post the message | 976 977### Disable Mattermost Slash Command integration 978 979Disable the Mattermost Slash Command integration for a project. Integration settings are preserved. 980 981```plaintext 982DELETE /projects/:id/integrations/mattermost-slash-commands 983``` 984 985## Packagist 986 987Update your project on Packagist (the main Composer repository) when commits or tags are pushed to GitLab. 988 989### Create/Edit Packagist integration 990 991Set Packagist integration for a project. 992 993```plaintext 994PUT /projects/:id/integrations/packagist 995``` 996 997Parameters: 998 999| Parameter | Type | Required | Description | 1000| --------- | ---- | -------- | ----------- | 1001| `username` | string | yes | The username of a Packagist account | 1002| `token` | string | yes | API token to the Packagist server | 1003| `server` | boolean | no | URL of the Packagist server. Leave blank for default: <https://packagist.org> | 1004| `push_events` | boolean | false | Enable notifications for push events | 1005| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 1006| `tag_push_events` | boolean | false | Enable notifications for tag push events | 1007 1008### Disable Packagist integration 1009 1010Disable the Packagist integration for a project. Integration settings are preserved. 1011 1012```plaintext 1013DELETE /projects/:id/integrations/packagist 1014``` 1015 1016### Get Packagist integration settings 1017 1018Get Packagist integration settings for a project. 1019 1020```plaintext 1021GET /projects/:id/integrations/packagist 1022``` 1023 1024## Pipeline-Emails 1025 1026Get emails for GitLab CI/CD pipelines. 1027 1028### Create/Edit Pipeline-Emails integration 1029 1030Set Pipeline-Emails integration for a project. 1031 1032```plaintext 1033PUT /projects/:id/integrations/pipelines-email 1034``` 1035 1036Parameters: 1037 1038| Parameter | Type | Required | Description | 1039| --------- | ---- | -------- | ----------- | 1040| `recipients` | string | yes | Comma-separated list of recipient email addresses | 1041| `add_pusher` | boolean | no | Add pusher to recipients list | 1042| `notify_only_broken_pipelines` | boolean | no | Notify only broken pipelines | 1043| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected. The default value is "default" | 1044| `notify_only_default_branch` | boolean | no | Send notifications only for the default branch ([introduced in GitLab 12.0](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/28271)) | 1045| `pipeline_events` | boolean | false | Enable notifications for pipeline events | 1046 1047### Disable Pipeline-Emails integration 1048 1049Disable the Pipeline-Emails integration for a project. Integration settings are preserved. 1050 1051```plaintext 1052DELETE /projects/:id/integrations/pipelines-email 1053``` 1054 1055### Get Pipeline-Emails integration settings 1056 1057Get Pipeline-Emails integration settings for a project. 1058 1059```plaintext 1060GET /projects/:id/integrations/pipelines-email 1061``` 1062 1063## Pivotal Tracker 1064 1065Add commit messages as comments to Pivotal Tracker stories. 1066 1067See also the [Pivotal Tracker integration documentation](../user/project/integrations/pivotal_tracker.md). 1068 1069### Create/Edit Pivotal Tracker integration 1070 1071Set Pivotal Tracker integration for a project. 1072 1073```plaintext 1074PUT /projects/:id/integrations/pivotaltracker 1075``` 1076 1077Parameters: 1078 1079| Parameter | Type | Required | Description | 1080| --------- | ---- | -------- | ----------- | 1081| `token` | string | true | The Pivotal Tracker token | 1082| `restrict_to_branch` | boolean | false | Comma-separated list of branches to automatically inspect. Leave blank to include all branches. | 1083| `push_events` | boolean | false | Enable notifications for push events | 1084 1085### Disable Pivotal Tracker integration 1086 1087Disable the Pivotal Tracker integration for a project. Integration settings are preserved. 1088 1089```plaintext 1090DELETE /projects/:id/integrations/pivotaltracker 1091``` 1092 1093### Get Pivotal Tracker integration settings 1094 1095Get Pivotal Tracker integration settings for a project. 1096 1097```plaintext 1098GET /projects/:id/integrations/pivotaltracker 1099``` 1100 1101## Prometheus 1102 1103Prometheus is a powerful time-series monitoring service. 1104 1105### Create/Edit Prometheus integration 1106 1107Set Prometheus integration for a project. 1108 1109```plaintext 1110PUT /projects/:id/integrations/prometheus 1111``` 1112 1113Parameters: 1114 1115| Parameter | Type | Required | Description | 1116| --------- | ---- | -------- | ----------- | 1117| `api_url` | string | true | Prometheus API Base URL. For example, `http://prometheus.example.com/`. | 1118| `google_iap_audience_client_id` | string | false | Client ID of the IAP secured resource (looks like IAP_CLIENT_ID.apps.googleusercontent.com) | 1119| `google_iap_service_account_json` | string | false | `credentials.json` file for your service account, like { "type": "service_account", "project_id": ... } | 1120 1121### Disable Prometheus integration 1122 1123Disable the Prometheus integration for a project. Integration settings are preserved. 1124 1125```plaintext 1126DELETE /projects/:id/integrations/prometheus 1127``` 1128 1129### Get Prometheus integration settings 1130 1131Get Prometheus integration settings for a project. 1132 1133```plaintext 1134GET /projects/:id/integrations/prometheus 1135``` 1136 1137## Pushover 1138 1139Pushover makes it easy to get real-time notifications on your Android device, iPhone, iPad, and Desktop. 1140 1141### Create/Edit Pushover integration 1142 1143Set Pushover integration for a project. 1144 1145```plaintext 1146PUT /projects/:id/integrations/pushover 1147``` 1148 1149Parameters: 1150 1151| Parameter | Type | Required | Description | 1152| --------- | ---- | -------- | ----------- | 1153| `api_key` | string | true | Your application key | 1154| `user_key` | string | true | Your user key | 1155| `priority` | string | true | The priority | 1156| `device` | string | false | Leave blank for all active devices | 1157| `sound` | string | false | The sound of the notification | 1158| `push_events` | boolean | false | Enable notifications for push events | 1159 1160### Disable Pushover integration 1161 1162Disable the Pushover integration for a project. Integration settings are preserved. 1163 1164```plaintext 1165DELETE /projects/:id/integrations/pushover 1166``` 1167 1168### Get Pushover integration settings 1169 1170Get Pushover integration settings for a project. 1171 1172```plaintext 1173GET /projects/:id/integrations/pushover 1174``` 1175 1176## Redmine 1177 1178Redmine issue tracker 1179 1180### Create/Edit Redmine integration 1181 1182Set Redmine integration for a project. 1183 1184```plaintext 1185PUT /projects/:id/integrations/redmine 1186``` 1187 1188Parameters: 1189 1190| Parameter | Type | Required | Description | 1191| --------- | ---- | -------- | ----------- | 1192| `new_issue_url` | string | true | New Issue URL | 1193| `project_url` | string | true | Project URL | 1194| `issues_url` | string | true | Issue URL | 1195| `description` | string | false | Description | 1196| `push_events` | boolean | false | Enable notifications for push events | 1197 1198### Disable Redmine integration 1199 1200Disable the Redmine integration for a project. Integration settings are preserved. 1201 1202```plaintext 1203DELETE /projects/:id/integrations/redmine 1204``` 1205 1206### Get Redmine integration settings 1207 1208Get Redmine integration settings for a project. 1209 1210```plaintext 1211GET /projects/:id/integrations/redmine 1212``` 1213 1214## Slack notifications 1215 1216Receive event notifications in Slack 1217 1218### Create/Edit Slack integration 1219 1220Set Slack integration for a project. 1221 1222```plaintext 1223PUT /projects/:id/integrations/slack 1224``` 1225 1226Parameters: 1227 1228| Parameter | Type | Required | Description | 1229| --------- | ---- | -------- | ----------- | 1230| `webhook` | string | true | `https://hooks.slack.com/services/...` | 1231| `username` | string | false | username | 1232| `channel` | string | false | Default channel to use if others are not configured | 1233| `notify_only_broken_pipelines` | boolean | false | Send notifications for broken pipelines | 1234| `notify_only_default_branch` | boolean | false | DEPRECATED: This parameter has been replaced with `branches_to_be_notified` | 1235| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected". The default value is "default" | 1236| `commit_events` | boolean | false | Enable notifications for commit events | 1237| `confidential_issue_channel` | string | false | The name of the channel to receive confidential issues events notifications | 1238| `confidential_issues_events` | boolean | false | Enable notifications for confidential issue events | 1239| `confidential_note_channel` | string | false | The name of the channel to receive confidential note events notifications | 1240| `confidential_note_events` | boolean | false | Enable notifications for confidential note events | 1241| `deployment_channel` | string | false | The name of the channel to receive deployment events notifications | 1242| `deployment_events` | boolean | false | Enable notifications for deployment events | 1243| `issue_channel` | string | false | The name of the channel to receive issues events notifications | 1244| `issues_events` | boolean | false | Enable notifications for issue events | 1245| `job_events` | boolean | false | Enable notifications for job events | 1246| `merge_request_channel` | string | false | The name of the channel to receive merge request events notifications | 1247| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 1248| `note_channel` | string | false | The name of the channel to receive note events notifications | 1249| `note_events` | boolean | false | Enable notifications for note events | 1250| `pipeline_channel` | string | false | The name of the channel to receive pipeline events notifications | 1251| `pipeline_events` | boolean | false | Enable notifications for pipeline events | 1252| `push_channel` | string | false | The name of the channel to receive push events notifications | 1253| `push_events` | boolean | false | Enable notifications for push events | 1254| `tag_push_channel` | string | false | The name of the channel to receive tag push events notifications | 1255| `tag_push_events` | boolean | false | Enable notifications for tag push events | 1256| `wiki_page_channel` | string | false | The name of the channel to receive wiki page events notifications | 1257| `wiki_page_events` | boolean | false | Enable notifications for wiki page events | 1258 1259### Disable Slack integration 1260 1261Disable the Slack integration for a project. Integration settings are preserved. 1262 1263```plaintext 1264DELETE /projects/:id/integrations/slack 1265``` 1266 1267### Get Slack integration settings 1268 1269Get Slack integration settings for a project. 1270 1271```plaintext 1272GET /projects/:id/integrations/slack 1273``` 1274 1275## Microsoft Teams 1276 1277Group Chat Software 1278 1279### Create/Edit Microsoft Teams integration 1280 1281Set Microsoft Teams integration for a project. 1282 1283```plaintext 1284PUT /projects/:id/integrations/microsoft-teams 1285``` 1286 1287Parameters: 1288 1289| Parameter | Type | Required | Description | 1290| --------- | ---- | -------- | ----------- | 1291| `webhook` | string | true | The Microsoft Teams webhook. For example, `https://outlook.office.com/webhook/...` | 1292| `notify_only_broken_pipelines` | boolean | false | Send notifications for broken pipelines | 1293| `notify_only_default_branch` | boolean | false | DEPRECATED: This parameter has been replaced with `branches_to_be_notified` | 1294| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected". The default value is "default" | 1295| `push_events` | boolean | false | Enable notifications for push events | 1296| `issues_events` | boolean | false | Enable notifications for issue events | 1297| `confidential_issues_events` | boolean | false | Enable notifications for confidential issue events | 1298| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 1299| `tag_push_events` | boolean | false | Enable notifications for tag push events | 1300| `note_events` | boolean | false | Enable notifications for note events | 1301| `confidential_note_events` | boolean | false | Enable notifications for confidential note events | 1302| `pipeline_events` | boolean | false | Enable notifications for pipeline events | 1303| `wiki_page_events` | boolean | false | Enable notifications for wiki page events | 1304 1305### Disable Microsoft Teams integration 1306 1307Disable the Microsoft Teams integration for a project. Integration settings are preserved. 1308 1309```plaintext 1310DELETE /projects/:id/integrations/microsoft-teams 1311``` 1312 1313### Get Microsoft Teams integration settings 1314 1315Get Microsoft Teams integration settings for a project. 1316 1317```plaintext 1318GET /projects/:id/integrations/microsoft-teams 1319``` 1320 1321## Mattermost notifications 1322 1323Receive event notifications in Mattermost 1324 1325### Create/Edit Mattermost notifications integration 1326 1327Set Mattermost notifications integration for a project. 1328 1329```plaintext 1330PUT /projects/:id/integrations/mattermost 1331``` 1332 1333Parameters: 1334 1335| Parameter | Type | Required | Description | 1336| --------- | ---- | -------- | ----------- | 1337| `webhook` | string | true | The Mattermost webhook. For example, `http://mattermost_host/hooks/...` | 1338| `username` | string | false | username | 1339| `channel` | string | false | Default channel to use if others are not configured | 1340| `notify_only_broken_pipelines` | boolean | false | Send notifications for broken pipelines | 1341| `notify_only_default_branch` | boolean | false | DEPRECATED: This parameter has been replaced with `branches_to_be_notified` | 1342| `branches_to_be_notified` | string | false | Branches to send notifications for. Valid options are "all", "default", "protected", and "default_and_protected". The default value is "default" | 1343| `push_events` | boolean | false | Enable notifications for push events | 1344| `issues_events` | boolean | false | Enable notifications for issue events | 1345| `confidential_issues_events` | boolean | false | Enable notifications for confidential issue events | 1346| `merge_requests_events` | boolean | false | Enable notifications for merge request events | 1347| `tag_push_events` | boolean | false | Enable notifications for tag push events | 1348| `note_events` | boolean | false | Enable notifications for note events | 1349| `confidential_note_events` | boolean | false | Enable notifications for confidential note events | 1350| `pipeline_events` | boolean | false | Enable notifications for pipeline events | 1351| `wiki_page_events` | boolean | false | Enable notifications for wiki page events | 1352| `push_channel` | string | false | The name of the channel to receive push events notifications | 1353| `issue_channel` | string | false | The name of the channel to receive issues events notifications | 1354| `confidential_issue_channel` | string | false | The name of the channel to receive confidential issues events notifications | 1355| `merge_request_channel` | string | false | The name of the channel to receive merge request events notifications | 1356| `note_channel` | string | false | The name of the channel to receive note events notifications | 1357| `confidential_note_channel` | string | false | The name of the channel to receive confidential note events notifications | 1358| `tag_push_channel` | string | false | The name of the channel to receive tag push events notifications | 1359| `pipeline_channel` | string | false | The name of the channel to receive pipeline events notifications | 1360| `wiki_page_channel` | string | false | The name of the channel to receive wiki page events notifications | 1361 1362### Disable Mattermost notifications integration 1363 1364Disable the Mattermost notifications integration for a project. Integration settings are preserved. 1365 1366```plaintext 1367DELETE /projects/:id/integrations/mattermost 1368``` 1369 1370### Get Mattermost notifications integration settings 1371 1372Get Mattermost notifications integration settings for a project. 1373 1374```plaintext 1375GET /projects/:id/integrations/mattermost 1376``` 1377 1378## JetBrains TeamCity CI 1379 1380A continuous integration and build server 1381 1382### Create/Edit JetBrains TeamCity CI integration 1383 1384Set JetBrains TeamCity CI integration for a project. 1385 1386> The build configuration in TeamCity must use the build format number `%build.vcs.number%`. Configure monitoring of all branches so merge requests build. That setting is in the VSC root advanced settings. 1387 1388```plaintext 1389PUT /projects/:id/integrations/teamcity 1390``` 1391 1392Parameters: 1393 1394| Parameter | Type | Required | Description | 1395| --------- | ---- | -------- | ----------- | 1396| `teamcity_url` | string | true | TeamCity root URL. For example, `https://teamcity.example.com` | 1397| `build_type` | string | true | Build configuration ID | 1398| `username` | string | true | A user with permissions to trigger a manual build | 1399| `password` | string | true | The password of the user | 1400| `push_events` | boolean | false | Enable notifications for push events | 1401 1402### Disable JetBrains TeamCity CI integration 1403 1404Disable the JetBrains TeamCity CI integration for a project. Integration settings are preserved. 1405 1406```plaintext 1407DELETE /projects/:id/integrations/teamcity 1408``` 1409 1410### Get JetBrains TeamCity CI integration settings 1411 1412Get JetBrains TeamCity CI integration settings for a project. 1413 1414```plaintext 1415GET /projects/:id/integrations/teamcity 1416``` 1417 1418## Jenkins CI 1419 1420A continuous integration and build server 1421 1422### Create/Edit Jenkins CI integration 1423 1424Set Jenkins CI integration for a project. 1425 1426```plaintext 1427PUT /projects/:id/integrations/jenkins 1428``` 1429 1430Parameters: 1431 1432| Parameter | Type | Required | Description | 1433| --------- | ---- | -------- | ----------- | 1434| `jenkins_url` | string | true | Jenkins URL like `http://jenkins.example.com`. | 1435| `project_name` | string | true | The URL-friendly project name. Example: `my_project_name`. | 1436| `username` | string | false | Username for authentication with the Jenkins server, if authentication is required by the server. | 1437| `password` | string | false | Password for authentication with the Jenkins server, if authentication is required by the server. | 1438| `push_events` | boolean | false | Enable notifications for push events. | 1439| `merge_requests_events` | boolean | false | Enable notifications for merge request events. | 1440| `tag_push_events` | boolean | false | Enable notifications for tag push events. | 1441 1442### Disable Jenkins CI integration 1443 1444Disable the Jenkins CI integration for a project. Integration settings are preserved. 1445 1446```plaintext 1447DELETE /projects/:id/integrations/jenkins 1448``` 1449 1450### Get Jenkins CI integration settings 1451 1452Get Jenkins CI integration settings for a project. 1453 1454```plaintext 1455GET /projects/:id/integrations/jenkins 1456``` 1457 1458## Jenkins CI (Deprecated) integration 1459 1460A continuous integration and build server 1461 1462NOTE: 1463This integration was [removed](https://gitlab.com/gitlab-org/gitlab/-/issues/1600) in GitLab 13.0. 1464 1465### Create/Edit Jenkins CI (Deprecated) integration 1466 1467Set Jenkins CI (Deprecated) integration for a project. 1468 1469```plaintext 1470PUT /projects/:id/integrations/jenkins-deprecated 1471``` 1472 1473Parameters: 1474 1475- `project_url` (**required**) - Jenkins project URL like `http://jenkins.example.com/job/my-project/` 1476- `multiproject_enabled` (optional) - Multi-project mode is configured in Jenkins GitLab Hook plugin 1477- `pass_unstable` (optional) - Unstable builds are treated as passing 1478 1479### Disable Jenkins CI (Deprecated) integration 1480 1481Disable the Jenkins CI (Deprecated) integration for a project. Integration settings are preserved. 1482 1483```plaintext 1484DELETE /projects/:id/integrations/jenkins-deprecated 1485``` 1486 1487### Get Jenkins CI (Deprecated) integration settings 1488 1489Get Jenkins CI (Deprecated) integration settings for a project. 1490 1491```plaintext 1492GET /projects/:id/integrations/jenkins-deprecated 1493``` 1494 1495## MockCI 1496 1497Mock an external CI. See [`gitlab-org/gitlab-mock-ci-service`](https://gitlab.com/gitlab-org/gitlab-mock-ci-service) for an example of a companion mock integration. 1498 1499This integration is only available when your environment is set to development. 1500 1501### Create/Edit MockCI integration 1502 1503Set MockCI integration for a project. 1504 1505```plaintext 1506PUT /projects/:id/integrations/mock-ci 1507``` 1508 1509Parameters: 1510 1511| Parameter | Type | Required | Description | 1512| --------- | ---- | -------- | ----------- | 1513| `mock_service_url` | string | true | `http://localhost:4004` | 1514 1515### Disable MockCI integration 1516 1517Disable the MockCI integration for a project. Integration settings are preserved. 1518 1519```plaintext 1520DELETE /projects/:id/integrations/mock-ci 1521``` 1522 1523### Get MockCI integration settings 1524 1525Get MockCI integration settings for a project. 1526 1527```plaintext 1528GET /projects/:id/integrations/mock-ci 1529``` 1530 1531## YouTrack 1532 1533YouTrack issue tracker 1534 1535### Create/Edit YouTrack integration 1536 1537Set YouTrack integration for a project. 1538 1539```plaintext 1540PUT /projects/:id/integrations/youtrack 1541``` 1542 1543Parameters: 1544 1545| Parameter | Type | Required | Description | 1546| --------- | ---- | -------- | ----------- | 1547| `issues_url` | string | true | Issue URL | 1548| `project_url` | string | true | Project URL | 1549| `description` | string | false | Description | 1550| `push_events` | boolean | false | Enable notifications for push events | 1551 1552### Disable YouTrack integration 1553 1554Disable the YouTrack integration for a project. Integration settings are preserved. 1555 1556```plaintext 1557DELETE /projects/:id/integrations/youtrack 1558``` 1559 1560### Get YouTrack integration settings 1561 1562Get YouTrack integration settings for a project. 1563 1564```plaintext 1565GET /projects/:id/integrations/youtrack 1566``` 1567