---
title: "Create DOI"
method: PUT
path: "/doi/{doi}"
---

# Create DOI

`PUT /doi/{doi}`

## Request

- Base URL: `https://mds.test.datacite.org`
- URL: `https://mds.test.datacite.org/doi/{doi}`
- Auth: HTTP basic

Registers a new DOI if the specified DOI doesn’t exist. This method will attempt to update the URL if you specify an existing DOI. Creating a DOI requires authentication credentials.Note that metadata must be registered for a DOI first, using the [create metadata call](metadata#create-metadata-record-2).

## Path parameters

- `doi` string, required

## Headers

- `Content-Type` string, required
- `charset` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `RAW_BODY` string: doi and url separated by newline, e.g. "doi=10.5072/0000-03VC\nurl=http://example.org/"

## Response `201`

201

## Other responses

- `401`: 401

---

[API](https://skmtc.dev/datacite/apis/mds.md) - [All operations](https://skmtc.dev/datacite/apis/mds/llms.txt) - [OpenAPI document](https://skmtc.dev/datacite/apis/mds/revisions/0ea088ad989d?raw)