---
title: "Create a Live Event"
method: POST
path: "/api/v2/content/{id}/relationships/sessions"
tags: ["Content - Live Events"]
---

# Create a Live Event

`POST /api/v2/content/{id}/relationships/sessions`

This endpoint creates a live event for a specific course or event. Live events can only be created for courses or event content types.<br><br><h3>Required Scope</h3>`content:write`

## Path parameters

- `id` string, required

## Request body

- RelationshipsSessionsBody
  - `data` Apiv2contentidrelationshipssessionsData
    - `attributes` Apiv2contentidrelationshipssessionsDataAttributes
      - `location-type` string, required — The type of live event location. Can only be 'InPerson', 'Hybrid', or 'Online'.
      - `registration-url` string, nullable — Must be a relative or absolute URI.
      - `location-url` string — Must be a relative or absolute URI. This value is required when 'location-type' is either 'Hybrid' or 'Online'. There is max length of 500 for this value.
      - `location-address` string — This value is required when 'location-type' is either 'Hybrid' or 'InPerson'. There is a max length of 300 for this value.
      - `external-id` string, nullable — The external ID of the live event. The maximum length for this value is 2000 characters.
      - `utc-start-date-time` string, date-time, required
      - `utc-end-date-time` string, date-time, required
      - `is-active` boolean
      - `time-zone` string, nullable — This value must be a IANA time zone.

## Response `201`

Success

- InlineResponse2015
  - `data` ListedLiveEventData[]
    - `type` string
    - `id` string
    - `attributes` ListedLiveEventDataAttributes
      - `title` string — The title of the course or event.
      - `location-type` string — The type of live event location. Can only be 'InPerson', 'Hybrid', or 'Online'.
      - `registration-url` string — Must be a relative or absolute URI.
      - `location-url` string — Must be a relative or absolute URI. This value is required when 'location-type' is either 'Hybrid' or 'Online'.
      - `location-address` string — This value is required when 'location-type' is either 'Hybrid' or 'InPerson'.
      - `external-id` string — The external ID of the live event.
      - `utc-start-date-time` string, date-time
      - `utc-end-date-time` string, date-time
      - `created-at` string, date-time
      - `modified-at` string, date-time
      - `is-active` boolean
      - `time-zone` string
      - `content-type` string
    - `links` SelfLink
      - `self` string
    - `relationships` ListedLiveEventDataRelationships[]
      - `content` ListedLiveEventDataContent
        - `data` ListedLiveEventDataContentData
          - `id` string, nullable
          - `type` string, nullable

---

[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)