---
title: "Create project transfer request"
method: POST
path: "/projects/{idOrName}/transfer-request"
tags: ["projects"]
---

# Create project transfer request

`POST /projects/{idOrName}/transfer-request`

Initiates a project transfer request from one team to another. <br/> Returns a `code` that remains valid for 24 hours and can be used to accept the transfer request by another team using the `PUT /projects/transfer-request/:code` endpoint. <br/> Users can also accept the project transfer request using the claim URL: `https://vercel.com/claim-deployment?code=<code>&returnUrl=<returnUrl>`. <br/> The `code` parameter specifies the project transfer request code generated using this endpoint. <br/> The `returnUrl` parameter redirects users to a specific page of the application if the claim URL is invalid or expired.

## Path parameters

- `idOrName` string, required — The ID or name of the project to transfer.

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `callbackUrl` string — The URL to send a webhook to when the transfer is accepted.
  - `callbackSecret` string — The secret to use to sign the webhook payload with HMAC-SHA256.

## Response `200`

The project transfer request has been initiated successfully.

- object
  - `code` string, required — Code that can be used to accept the project transfer request.

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/b4d86a3e3479/schema)
