---
title: "Create a New Evidence Item"
method: POST
path: "/v1/credentials/{credential_id}/evidence_items"
tags: ["Evidence Items"]
---

# Create a New Evidence Item

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

## Path parameters

- `credential_id` string, required

## Request body

- object
  - `evidence_item` object
    - `description` string, required — Title text for the evidence item. This is displayed on a Credential.
    - `category` 'file' | 'url' | 'video' | 'grade' | 'transcript', required — Type of Evidence Item added, must be one of [file, url, video, grade, transcript]. The type dictates how the item is displayed on the certificate.
    - `url` string — If the category is url or video, this should be the URL of Evidence Item.
    - `file` string — If the category is file, this should be the file's URL.
    - `string_object` string — If the category is grade or transcript then use it. For grade it will be just string 83.
    - `preview` string — By default if you add a URL category EvidenceItem, we take a screenshot to set the preview of this URL on Credential. You can overwrite this default behaviour by setting this preview field to be the URL of the desired image.
    - `position` number — The numeric position of the evidence item on the credential. 0 is displayed first in the list.
    - `custom_insight` string — The insights which will appear below Evidence Item, if not given it will be generated automatically based on data.

## Response `200`

OK

- object
  - `evidence_item` object
    - `id` number
    - `description` string
    - `link_url` string
    - `preview_image_url` string
    - `type` string
    - `supplemental` boolean
    - `string_object` unknown
    - `position` number

---

[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/versions/56b317c13686/schema)