---
title: "Add a contributor to a Draft Registration"
method: POST
path: "/draft_registrations/{draft_id}/contributors/"
tags: ["Draft Registrations"]
---

# Add a contributor to a Draft Registration

`POST /draft_registrations/{draft_id}/contributors/`

Adds a contributor to a Draft Registration, contributors can view, edit, register or delete a Draft Registration depending on their permissions.
Contributors are categorized as either "bibliographic" or "non-bibliographic" contributors. From a permissions standpoint, both are the same, but bibliographic contributors are included in citations and are listed on the project overview page on the OSF, while non-bibliographic contributors are not.
#### Permissions
Only project administrators can add contributors to a Draft Registration.
#### Required
A relationship object with a `data` key, containing the `users` type and valid user ID is required.
All attributes describing the relationship between the node and the user are optional.
#### Returns
Returns a JSON object with a `data` key containing the representation of the new contributor, 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](#tag/Errors-and-Error-Codes) to understand why this request may have failed.

## Path parameters

- `draft_id` string, required

## Request body

- object
  - `id` string — The identifier of the contributor entity. Contributor identifiers have the form {node_id}-{user_id}.
  - `type` string, required — The type identifier of the contributor entity (`contributors`).
  - `attributes` object — The properties of the contributor entity.
    - `bibliographic` boolean — Whether or not the contributor will be included in citations for the node. The default value is true.
    - `index` integer — The position of this contributor in the list of project contributors and in project citations.
    - `permission` 'read' | 'write' | 'admin' — The permission level of the contributor. The default value is 'write'.
    - `unregistered_contributor` string — The assigned name of the contributor if the contributor has not yet claimed their account.
  - `relationships` object, required — URLs to other entities or entity collections that have a relationship to the contributor entity.
    - `node` string, required — A relationship to the node that was created for the preprint, or from which the preprint was created.
    - `user` string, required — A relationship to the file that is designated as the preprint's primary file, or the manuscript of the preprint.
  - `links` object — URLs to alternative representations of the contributor entity.
    - `self` string, URL — A link to the the canonical API endpoint for the contributor.

## 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/versions/ca701048eb0d/schema)
