---
title: "Register a release from a deploy platform's own webhook (Vercel deploy-hook connector)"
method: POST
path: "/errors/releases/inbound/{token}"
tags: ["Errors"]
---

# Register a release from a deploy platform's own webhook (Vercel deploy-hook connector)

`POST /errors/releases/inbound/{token}`

## Request

- Base URL: `https://realuptime.io/api/v1`
- URL: `https://realuptime.io/api/v1/errors/releases/inbound/{token}`
- Auth: none required

## Path parameters

- `token` string, required

## Query parameters

- `source` 'vercel'

## Request body

- object
  - `type` string, required
  - `payload` object, required

## Response `200`

The release already existed; its metadata was updated.

- object
  - `source` 'vercel', required
  - `release` string, required
  - `releaseId` string, required
  - `created` boolean, required

## Other responses

- `201`: The release was registered for the first time.
- `400`: Body not JSON, not Vercel's documented shape, or an event type that isn't a live deployment. - `RU-4014` Inbound release payload not understood: https://realuptime.io/kb/errors/ru-4014
- `401`: Webhook has a signing secret and the X-RealUptime-Signature header is missing or wrong. - `RU-4015` Inbound release signature missing or wrong: https://realuptime.io/kb/errors/ru-4015
- `404`: Unknown or revoked token (indistinguishable from outside). - `RU-4013` Inbound release webhook token not recognized: https://realuptime.io/kb/errors/ru-4013
- `429`: Per-token budget exceeded; Retry-After says when. - `RU-4016` Inbound release webhook rate limited: https://realuptime.io/kb/errors/ru-4016

---

[API](https://skmtc.dev/realuptime/apis/realuptime-api-v1.md) · [All operations](https://skmtc.dev/realuptime/apis/realuptime-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/realuptime/apis/realuptime-api-v1/revisions/51e481084700?raw)