---
title: Review
description: Automate reviews for your pull requests with customizable comments and review types.
---

The `review` action provides you with an automated way to review pull requests.
This can be particularly useful in situations where you want to automatically
approve pull requests that meet certain criteria, or to request changes on a
pull request when a particular check fails.

## Parameters

| Key name | Value type | Default | Description |
| --- | --- | --- | --- |
| `bot_account` | simple-template or null | `null` | Mergify can impersonate a GitHub user to review a pull request. If no `bot_account` is set, Mergify will review the pull request itself. |
| `message` | simple-template or null | `null` | The message to post in the review |
| `type` | `APPROVE` or `REQUEST_CHANGES` or `COMMENT` | `"APPROVE"` | The type of review to post |

## Examples

### Approve a pull request when all checks have passed

```yaml
pull_request_rules:
  - name: automatic approval
    conditions:
      - check-success = myfirstCIname
      - check-success = mysecondCIname
    actions:
      review:
        type: APPROVE
```

In this example, Mergify will automatically approve any pull request once all
checks have passed successfully.

### Approve Dependabot Pull Requests

You can use Mergify to review a pull request on your behalf. This can be handy
if you require a minimum number of reviews to be present on a pull request
(e.g., due to [branch
protection](https://docs.github.com/en/github/administering-a-repository/about-protected-branches))
but want to automate some merges.

[Dependabot](https://github.com/features/security) is the bot behind GitHub's
automatic security updates. It sends automatic updates for your project's
dependencies, making sure they are secure. You can automate the approval of
pull requests created by `dependabot` with a rule such as:

```yaml
pull_request_rules:
  - name: automatic approval for Dependabot pull requests
    conditions:
      - author = dependabot[bot]
    actions:
      review:
        type: APPROVE
        message: Automatically approving dependabot
```