Help Center/ CodeArts Repo/ User Guide/ Configuring Project-Level Settings for CodeArts Repo/ Configuring Webhook Settings
Updated on 2026-06-24 GMT+08:00
View PDF
Share

Configuring Webhook Settings

Overview

Developers can configure URLs of third-party systems on the Webhook page and subscribe to events such as branch push and tag push of CodeArts Repo based on project requirements.

When a subscribed event occurs, you can use a webhook to send a POST request to the URL of a third-party system to trigger corresponding operations (in the third-party system), such as popping up a notification window, building or updating images, or performing deployment.

Before configuring a merge request rule, check Constraints. If you have the configuration permission, configure the rule based on Configuring Webhook Settings. For details about the configuration example, see Helpful Links.

Constraints

Table 1 Constraints

Item

Description

Permission settings

Users with the project manager or project administrator role can set project-level webhooks. For details, see Configuring Project-Level Permissions.

Function constraint

A maximum of 20 webhooks can be created for a repository.

Configuring Webhook Settings

Go to the CodeArts Repo page of the project to be configured and choose Settings > Service Integration > Webhooks in the top navigation bar.

Click Add Webhook and set parameters as instructed in Table 2. The configuration example is shown in Helpful Links.

Table 2 Parameters for creating a webhook

Parameter

Description

Example Value

Name

Custom name with up to 200 characters.

Webhook_Test

Description

Optional. Used to describe the webhook with up to 200 characters.

Test

URL

The URL and its response cannot contain sensitive data or the sensitive data must be encrypted and decrypted for security. Provided by the third-party CI/CD system.

https://example.com

Token Type

Optional. Used for authentication of third-party services' webhook APIs. The authentication information should be placed in the HTTP request header as the key and used together with the token. Three options are available:

  • X-Repo-Token
  • X-Gitlab-Token
  • X-Auth-Token

You can also enter a custom token type.

You can configure a token when setting up a webhook. The token will be associated with the webhook URL and sent to you in the X-Repo-Token header.

X-Repo-Token

Token

Optional. After you set Token Type, this parameter is used as the value and is used together with the token type.

Enter a custom value, with max. 2,000 characters. Used for third-party CI/CD system authentication. The authentication information is stored in the HTTP request header.

Token_Test

Trigger Events

You can subscribe to the following events:

  • Code push After this option is selected, you need to enter the Regular Expression for Branch Filtering with up to 500 characters. .* indicates that all branches are matched. If the branch name matches the configured regular expression and the code is updated (code updates in sub-modules; online or offline code push in Git client), the event will be triggered.
  • Merge requests After this option is selected, updating the merge request code, closing merge requests, re-opening merge requests, updating merge request title or description, updating the merger and the work item, deleting source branches, or updating the Squash merge will trigger this event.
  • Tag push After this option is selected, both creating and deleting a tag will trigger this event.
  • Comments After this option is selected, this event will be triggered when a review is added to a code file, a file change in a code commit, or a merge request, or when a comment is added to a repository's commit details or merge request details.
  • Select Code Push and set Regular Expression for Branch Filtering to Branch_*. This indicates that the push of all branches starting with Branch_ will trigger this event.
  • Select Merge requests.
  • Select Tag push.

Setting Repository Event Triggers

For example, to interconnect with CodeArts Pipeline, perform the following steps:

  1. Create a pipeline by referring to Creating a Pipeline.
  2. Edit the pipeline. Click Trigger Settings, enable Webhook, and configure the event triggers by referring to Configuring Event Triggers.

  3. Go to the code repository of the pipeline and choose Settings > Service Integration > Webhooks.
  4. Check the system webhook registered by CodeArts Pipeline. System webhooks cannot be edited or deleted. You can only test them and view their execution logs.

Helpful Links

After the configuration is complete, the webhook of push event is triggered. As shown in the following figure, 200 is returned. If the token value in the code example is different from that configured in the table, the authentication fails and the error code 401 is returned.