---
title: "Create a New Reference"
method: POST
path: "/v1/credentials/{credential_id}/references"
tags: ["References"]
---

# Create a New Reference

`POST /v1/credentials/{credential_id}/references`

You may create a Reference using this action. It takes a JSON object containing a Reference.

## Path parameters

- `credential_id` string, required

## Request body

- object
  - `reference` object
    - `description` string, required — The reference comments / text.
    - `relationship` 'taught' | 'managed' | 'mentored' | 'worked' | 'studied' | 'friends' | 'stranger' | 'professor', required — Must be one of: "taught", "managed", "mentored", "worked", "studied", "friends", "stranger", "professor".
    - `referee` object
      - `name` string — Name of the person providing the reference.
      - `email` string — Email of the person providing the reference.
      - `avatar` string — URL of image of the person providing the reference.
      - `url` string — URL of a social profile such as LinkedIn that would allow a viewer to learn more about the referee.
    - `position` number — The numeric position of the evidence item on the credential. 0 is displayed first in the list.

## Response `200`

OK

- object
  - `reference` object
    - `id` number
    - `description` string
    - `referee` object
      - `name` string
      - `email` string
      - `avatar` string
    - `supplemental` boolean
    - `relationship` string

---

[API](https://skmtc.net/accredible/apis/accredible-credential-api.md) · [All operations](https://skmtc.net/accredible/apis/accredible-credential-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/accredible/accredible-credential-api/revisions/56b317c13686/schema)