---
title: "Create a custom link"
method: POST
path: "/api/v2/custom-links"
tags: ["Custom Links"]
---

# Create a custom link

`POST /api/v2/custom-links`

> 🔑
>
> Required OAuth scope: `customLinks:write`.

Creates a custom link.

## Headers

- `360-api-version` 'v2.0', required

## Request body

- InputCustomLinkDTO
  - `name` string, required — The title displayed on the custom link.
  - `order` integer, required — The numeric display order (ascending). Links are arranged horizontally from left to right and wrap to the next line as needed.
  - `type` string, required — The unique identifier associated to your custom link. This information is not displayed to learners on the platform.
  - `iconName` 'agenda' | 'absence' | 'certificate' | 'convention' | 'default' | 'inbox' | 'survey' — The type of icon used on the custom link. By default, the link icon will be used.

## Response `201`

Returns the created custom link.

- CustomLinkDTO
  - `name` string, required — The title displayed on the custom link.
  - `order` integer, required — The numeric display order (ascending). Links are arranged horizontally from left to right and wrap to the next line as needed.
  - `type` string, required — The unique identifier associated to your custom link. This information is not displayed to learners on the platform.
  - `iconName` 'agenda' | 'absence' | 'certificate' | 'convention' | 'default' | 'inbox' | 'survey' — The type of icon used on the custom link. By default, the link icon will be used.
  - `_id` string, ObjectId, required — The ID of the custom link.

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error.
- `401` — The given access token is either missing, invalid, has expired, or has been revoked.
- `403` — The given access token does not have the required OAuth scope to execute the request.
- `429` — The client has sent too many requests in a short amount of time.

---

[API](https://skmtc.net/360learning/apis/core-api.md) · [All operations](https://skmtc.net/360learning/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/360learning/core-api/revisions/94b691b0b72c/schema)