---
title: "Create a New Experience"
method: POST
path: "/api/v2/experiences"
tags: ["Experiences"]
---

# Create a New Experience

`POST /api/v2/experiences`

This endpoint creates a new experience in the system. <h3>Required Scope</h3>`experiences:write`

## Request body

- V2ExperiencesBody
  - `data` Apiv2experiencesData
    - `type` string
    - `attributes` Apiv2experiencesDataAttributes
      - `tags` string[], required — Skills that are relevant to this experience.
      - `user-id` string, required
      - `user-identifier-type` string, required — Can be any of `UserId`, `Email`, `EmployeeId`, `AliasUid`, or `AliasEmail`.
      - `title` string, required
      - `description` string
      - `experience-type` string, required — The type of experience. Can be any of JobRole, Project, Mentorship, Menteeship, Shadowing, StretchAssignment, or Other.
      - `experience-type-peer-name` string — The mentee or mentor name. This field is required if `experience-type` is Mentorship or Menteeship.
      - `organization-name` string, required
      - `start-date` string, date-time, required
      - `end-date` string, date-time
      - `is-current` boolean, required — Indictaes whether this is the current position.
      - `seniority` string, required — Can be any of Junior, Intermediate, or Senior.
      - `weekly-hours` integer
      - `created-at` string, date-time
      - `modified-at` string, date-time
      - `points-earned` integer

## Response `201`

Success

- InlineResponse2018
  - `data` InlineResponse2018Data
    - `type` string
    - `id` string
    - `attributes` InlineResponse2018DataAttributes
      - `user-id` string
      - `user-identifier-type` string
      - `title` string
      - `description` string
      - `tags` string[]
      - `organization-name` string
      - `weekly-hours` integer
      - `start-date` string, date-time
      - `end-date` string, date-time
      - `is-current` boolean
      - `seniority` string
      - `experience-type` string
      - `experience-type-peer-name` string
    - `links` SelfLink
      - `self` string

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)