---
title: creates-a-new-check
product: vercel
url: /docs/rest-api/checks/creates-a-new-check
type: reference
prerequisites:
  []
related:
  - /docs/rest-api
summary: Learn about creates-a-new-check on Vercel.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# Creates a new Check

> **Deprecated**: This endpoint is deprecated and may be removed in a future version.

```http
POST /v1/deployments/{deploymentId}/checks
```

Creates a new check. This endpoint must be called with an OAuth2 or it will produce a 400 error.

## Authentication

**bearerToken**: HTTP bearer

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `deploymentId` | string | Yes | The deployment to create the check for. |


## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `teamId` | string | No | The Team identifier to perform the request on behalf of. |
| `slug` | string | No | The Team slug to perform the request on behalf of. |


## Request body

Required: Yes

Content-Type: `application/json`

```json
{
  "type": "object",
  "required": [
    "name",
    "blocking"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The name of the check being created",
      "maxLength": 100
    },
    "path": {
      "type": "string",
      "description": "Path of the page that is being checked",
      "maxLength": 255
    },
    "blocking": {
      "type": "boolean",
      "description": "Whether the check should block a deployment from succeeding"
    },
    "detailsUrl": {
      "type": "string",
      "description": "URL to display for further details"
    },
    "externalId": {
      "type": "string",
      "description": "An identifier that can be used as an external reference"
    },
    "rerequestable": {
      "type": "boolean",
      "description": "Whether a user should be able to request for the check to be rerun if it fails"
    }
  }
}
```

## Responses

### 200: No description

Content-Type: `application/json`

```json
{
  "type": "object",
  "required": [
    "blocking",
    "createdAt",
    "deploymentId",
    "id",
    "integrationId",
    "name",
    "status",
    "updatedAt"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "createdAt": {
      "type": "number"
    },
    "updatedAt": {
      "type": "number"
    },
    "deploymentId": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "running",
        "completed",
        "registered"
      ]
    },
    "conclusion": {
      "type": "string",
      "enum": [
        "canceled",
        "skipped",
        "failed",
        "neutral",
        "succeeded",
        "stale"
      ]
    },
    "externalId": {
      "type": "string"
    },
    "output": {
      "type": "object",
      "properties": {
        "metrics": {
          "type": "object",
          "required": [
            "CLS",
            "FCP",
            "LCP",
            "TBT"
          ],
          "properties": {
            "FCP": {
              "type": "object",
              "required": [
                "source",
                "value"
              ],
              "properties": {
                "value": {
                  "type": "number",
                  "nullable": true
                },
                "previousValue": {
                  "type": "number"
                },
                "source": {
                  "type": "string",
                  "enum": [
                    "web-vitals"
                  ]
                }
              }
            },
            "LCP": {
              "type": "object",
              "required": [
                "source",
                "value"
              ],
              "properties": {
                "value": {
                  "type": "number",
                  "nullable": true
                },
                "previousValue": {
                  "type": "number"
                },
                "source": {
                  "type": "string",
                  "enum": [
                    "web-vitals"
                  ]
                }
              }
            },
            "CLS": {
              "type": "object",
              "required": [
                "source",
                "value"
              ],
              "properties": {
                "value": {
                  "type": "number",
                  "nullable": true
                },
                "previousValue": {
                  "type": "number"
                },
                "source": {
                  "type": "string",
                  "enum": [
                    "web-vitals"
                  ]
                }
              }
            },
            "TBT": {
              "type": "object",
              "required": [
                "source",
                "value"
              ],
              "properties": {
                "value": {
                  "type": "number",
                  "nullable": true
                },
                "previousValue": {
                  "type": "number"
                },
                "source": {
                  "type": "string",
                  "enum": [
                    "web-vitals"
                  ]
                }
              }
            },
            "virtualExperienceScore": {
              "type": "object",
              "required": [
                "source",
                "value"
              ],
              "properties": {
                "value": {
                  "type": "number",
                  "nullable": true
                },
                "previousValue": {
                  "type": "number"
                },
                "source": {
                  "type": "string",
                  "enum": [
                    "web-vitals"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "completedAt": {
      "type": "number"
    },
    "path": {
      "type": "string"
    },
    "blocking": {
      "type": "boolean",
      "enum": [
        false,
        true
      ]
    },
    "detailsUrl": {
      "type": "string"
    },
    "integrationId": {
      "type": "string"
    },
    "startedAt": {
      "type": "number"
    },
    "rerequestable": {
      "type": "boolean",
      "enum": [
        false,
        true
      ]
    }
  }
}
```

### 400: One of the provided values in the request body is invalid.
One of the provided values in the request query is invalid.
Cannot create check for finished deployment
The provided token is not from an OAuth2 Client

### 401: The request is not authorized.

### 403: You do not have permission to access this resource.

### 404: The deployment was not found

---

## Related

- [checks endpoints](/docs/rest-api#checks)

- [REST API overview](/docs/rest-api)

- [OpenAPI spec](https://openapi.vercel.sh/) (machine-readable, all endpoints)

---

[View full sitemap](/docs/sitemap)