Trigger types
An automation has one trigger. To run the same task on a schedule and on an event, create two automations.
Schedules
A Scheduled trigger runs the automation at regular intervals. Set these fields:
The shortest interval is 10 minutes.
A one-time automation runs once at a time you choose and is then archived. You create it by asking
@coderabbit in Slack, for example âtomorrow at 10am, draft an RCA for this incident in this threadâ. See One-time automations.
Channel messages
A Slack message or Discord message trigger runs when a new top-level message is posted in a channel. Use it to react to repeated events, such as alerts from a monitoring bot, deployment notices, or questions in a help channel.
The editor has no author field. To limit the trigger to messages from particular authors, such as your Datadog bot, ask for it when you create the automation in Slack or Discord chat. See Slack channel message triggers.
Channel message automations always reply in the thread of the message that started the run, and their destination is on the same platform as the source channel. Run now isnât available. In Discord, an automation belongs to the parent channel even when itâs created in a thread. See Slack channel message triggers and Parent-channel scope.
Webhook events
A webhook trigger runs when another tool sends an event that matches the triggerâs rules. Select the providerâs tile in the Trigger card. Paused automations ignore webhook events.Supported providers
Provider tiles list the providerâs event types, so you can pick events instead of typing them. Custom accepts any event types you enter.
Managed webhooks
For GitHub, Jira, Linear, and PagerDuty, CodeRabbit creates the webhook in the provider and keeps it in sync with the automation. After you save, the editor confirms it, for example Jira webhook created, and no setup is needed in the provider.- GitHub: the trigger uses the repositories the CodeRabbit GitHub App can access, so you donât need a personal access token. Install the CodeRabbit GitHub App on the organization and repositories you want to use, then choose the Repository and Event types, such as
pull_requestorissues. For pull request events, Run only when narrows the trigger to pull requests that are merged, not merged, drafts, target a base branch, or have a head branch with a given prefix, or to a custom payload field. - Jira: under Jira projects, keep All projects or select up to 50 projects. Project selection works with issue, comment, work log, and issue property events. With other event types, the editor shows âProject scoping isnât available for the selected event types.â and the trigger covers all projects.
- Linear: choose a Linear authorization, or select Connect another Linear workspace to add one. CodeRabbit keeps your draft while you authorize and returns to the editor. Under Linear teams, keep All public teams or select teams.
- PagerDuty: the webhook subscription covers the whole PagerDuty account, not a single service or team.
The Create PR from Linear issue, Create PR from Jira issue, and Create PR from GitHub issue templates use this filter, so labeling a ticket is enough to start an implementation.
Other providers
For providers that CodeRabbit doesnât manage and for Custom, save the automation first. The editor then shows Webhook endpoint created with the webhook URL, the values to configure in the provider, such as a header or secret, and setup steps for that provider. Select Reveal secrets to see secret values. Configure the webhook in the provider, then test the trigger. Reusing a webhook connection that another automation already set up requires permission to manage integrations. While another active automation uses the same connection, its shared secret canât be changed.Matching rules
A webhook trigger decides which events start a run with matching rules:- Event types: the provider events to accept, such as
Issue.createfor Linear orincident.triggeredfor PagerDuty. Add more under Advanced > Additional event types. - Payload conditions: checks on fields in the eventâs payload, using equals, contains, starts with, exists, or a regular expression. GitHubâs Run only when filters and the ticket Filter row are payload conditions.
Deduplication
Providers sometimes deliver the same webhook event more than once. CodeRabbit deduplicates matching deliveries so a repeated event doesnât start a second run:- Window: a matching delivery with the same content is ignored for 60 seconds after the first one.
- GitHub, Linear, Jira, and PagerDuty: the same event keeps the same run identity after the window too, so redelivering it later doesnât start another run. Changes to delivery headers alone donât make it a new event.
- Linear retries: CodeRabbit ignores Linearâs delivery-only
webhookTimestampfield. Changing only that timestamp doesnât create a new event; the event content must change.
accepted and deduplicated are returned for automations that deliver to Slack or Discord. For automations without a Slack or Discord destination, the response contains only ok and matched.
Test a trigger
Follow the run on the automationâs page. If no run appears for a webhook, check that the automation is active, that the event type and conditions match, and that the delivery isnât a repeat within the deduplication window. See Manage and monitor automations.
Whatâs next
Automation destinations
Choose where each run delivers its result.
Manage and monitor automations
Follow runs and check why an automation did or didnât run.
Automation guides
See complete setups for incident response, support triage, and ticket triage.