---
title: "Create a preprint"
method: POST
path: "/preprints/"
tags: ["Preprints"]
---

# Create a preprint

`POST /preprints/`

Creates a new preprint.
#### Returns
Returns a JSON object with a `data` key containing the representation of the created preprint, if the request is successful.

If the request is unsuccessful, an `errors` key containing information about the failure will be returned. Refer to the [list of error codes]() to understand why this request may have failed.

## Request body

- object
  - `id` string — The identifier of the preprint entity.
  - `type` string, required — The type identifier of the preprint entity (`preprints`).
  - `attributes` object — The properties of the preprint entity.
    - `date_created` string, date-time — The time at which the preprint was created, as an iso8601 formatted timestamp.
    - `date_modified` string, date-time — The time at which the preprint was last modified, as an iso8601 formatted timestamp.
    - `date_published` string, date-time — The time at which the preprint was published, as an iso8601 formatted timestamp.
    - `doi` string — The DOI of the associated journal article, as entered by the user, if the preprint is published.
    - `title` string — The title of the preprint.
    - `description` string — The description of the preprint.
    - `is_preprint_orphan` boolean — Whether or not the preprint is orphaned. A preprint can be orphaned if it's primary file was removed from the preprint node. This field may be deprecated in future versions.
    - `license_record` string — The metadata (copyright year and holder) associated with a license, required for certain licenses.
    - `tags` string — The tags given to a preprint.
    - `preprint_doi_created` string — When the preprint DOI was created.
    - `date_withdrawn` boolean — The date the preprint was withdrawn, null if it was never withdrawn.
    - `current_user_permissions` string — The list of permissions the current user has.
    - `public` boolean — The wheter the preprint is public.
    - `reviews_state` string — The a label to indicate the state of review a preprint is in.
    - `date_last_transitioned` string — The date the reviews state of the preprint changed.
    - `has_coi` boolean — A value indicating whether the preprint has a conflict of interest statement.
    - `conflict_of_interest_statement` string — The text of the conflict of interest statement for the preprint.
    - `has_data_links` string — A value indicating whether the preprint has a links to data.
    - `why_no_data` string — A value for a field explaining why preregistration data was not included.
    - `data_links` 'available' | 'no' | 'not_applicable' — Any links to a preprints supplemental data go here.
    - `has_prereg_links` 'available' | 'no' | 'not_applicable' — A value indicating whether the preprint has any preregistration links.
    - `why_no_prereg` boolean — A value for a field explaining why preregistration links weren't included.
    - `prereg_links` string — Any links to a preprints preregistrations go here.
    - `prereg_link_info` string — The text of the any explanation of preprint preregistration link infomation.
    - `version` integer — Preprint version
  - `relationships` object, required — URLs to other entities or entity collections that have a relationship to the preprint entity.
    - `contributors` string — A relationship to the all contributors that are listed as contributing to this preprint.
    - `bibliographic_contributors` string — A relationship to the bibliographic contributors that are listed as contributing to this preprint.
    - `citation` string — A relationship to the citation of the preprint.
    - `identifiers` string — A relationship to the identifiers associated with the preprint.
    - `node` string, required — A relationship to the node that was created for the preprint, or from which the preprint was created.
    - `license` string — A relationship to the license that has been applied to the preprint.
    - `provider` string, required — A relationship to the preprint provider under which the preprint was created (OSF, socarxiv, psyarxiv, etc.).
    - `files` string — A relationship to files of the preprint.
    - `review_actions` string — A relationship to the review actions made of that preprint.
    - `requests` string — A relationship to the requests for sanction changes that was made to the preprint.
    - `affiliated_institutions` string — A relationship to the file that is designated as the preprint's primary file, or the manuscript of the preprint.
    - `subjects` string — A relationship to the academic subjects for the preprint.
  - `links` object — URLs to alternative representations of the preprint entity.
    - `iri` string, URL — The URL representation preprint of the OSF.
    - `html` string, URL — A link to the project on the OSF that was created for the preprint, or from which the preprint was created.
    - `preprint_doi` string, URL — The URL representation of the OSF assigned DOI for the preprint.
    - `self` string, URL — A link to the detail page for the preprint.

## Response `201`

Success

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/ca701048eb0d/schema)