Webhook operations rate limits
- Tier: Free, Premium, Ultimate
- Offering: GitLab Self-Managed, GitLab Dedicated
Configure the per-minute rate limit for requests that:
- Add a project webhook with the API.
- Create a group webhook with the API.
- Add a system hook with the API, or create a system hook in the Organization Admin area.
- Test a webhook.
- Resend a webhook event.
| Limit | Default |
|---|---|
| Project webhook creation requests | 5 each minute |
| Group webhook creation requests | 10 each minute |
| System hook creation requests | 5 each minute |
| Webhook test requests | 5 each minute |
| Webhook event resend requests | 5 each minute |
The project and group limits apply per user, for a given project or group. The webhook test limit also applies per user, for a given organization when you test an organization webhook. All webhooks in the same project, group, or organization share the limit. The system hook creation limit applies per user across the instance. The test and event resend limits cover both the UI and the API. The project and group webhook creation limits cover the API only. The system hook creation limit covers the API and the Organization Admin area.
These limits are separate from the webhook delivery rate limit, which limits how often webhooks can be triggered. Configuring webhook delivery rate limits depends on the type of instance:
- On GitLab Self-Managed, administrators configure it with the Plan limits API.
- On GitLab.com, the delivery limit depends on your plan and cannot be changed.
For example, if you set the webhook test rate limit to 5 and try to test a webhook six times in a minute, the final request is blocked. After a minute, you can test the webhook again.
The webhook creation limits count each request to create a webhook that passes authentication and
authorization, including requests that fail validation. Requests that exceed the limit return 429 Too Many Requests.
Change the rate limit
Prerequisites:
- Administrator access.
To change the rate limit:
- In the upper-right corner, select Admin.
- In the left sidebar, select Settings > Network.
- Expand Webhook rate limits.
- Set values for the available rate limits. Enter
0to disable a rate limit. - Select Save changes.
Requests that exceed the rate limit are logged to the auth.log file.