---
title: "Create a team link"
method: POST
path: "/api/v2/team/{team_id}/links"
tags: ["Teams"]
---

# Create a team link

`POST /api/v2/team/{team_id}/links`

Add a new link to a team.

## Path parameters

- `team_id` string, required

## Request body

- TeamLinkCreateRequest — Team link create request
  - `data` TeamLinkCreate, required — Team link create
    - `attributes` TeamLinkAttributes, required — Team link attributes
      - `label` string, required — The link's label
      - `position` integer — The link's position, used to sort links for the team
      - `team_id` string — ID of the team the link is associated with
      - `url` string, required — The URL for the link
    - `type` 'team_links', required — Team link type

## Response `200`

OK

- TeamLinkResponse — Team link response
  - `data` TeamLink — Team link
    - `attributes` TeamLinkAttributes, required — Team link attributes
      - `label` string, required — The link's label
      - `position` integer — The link's position, used to sort links for the team
      - `team_id` string — ID of the team the link is associated with
      - `url` string, required — The URL for the link
    - `id` string, required — The team link's identifier
    - `type` 'team_links', required — Team link type

## Other responses

- `403` — Forbidden
- `404` — API error response.
- `422` — API error response.
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)