0

Add Task Link

by
Published Oct 17, 2025

This is the equivalent of the feature _Task Links_ in the right-hand sidebar of a Task. It allows you to link two tasks together. General links or links to other objects than tasks are not supported.

Script clickup Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Clickup = {
3
  token: string;
4
};
5
/**
6
 * Add Task Link
7
 * This is the equivalent of the feature _Task Links_ in the right-hand sidebar of a Task.  It allows you to link two tasks together. General links or links to other objects than tasks are not supported.
8
 */
9
export async function main(
10
  auth: Clickup,
11
  task_id: string,
12
  links_to: string,
13
  custom_task_ids: string | undefined,
14
  team_id: string | undefined,
15
) {
16
  const url = new URL(
17
    `https://api.clickup.com/api/v2/task/${task_id}/link/${links_to}`,
18
  );
19
  for (const [k, v] of [
20
    ["custom_task_ids", custom_task_ids],
21
    ["team_id", team_id],
22
  ]) {
23
    if (v !== undefined && v !== "" && k !== undefined) {
24
      url.searchParams.append(k, v);
25
    }
26
  }
27
  const response = await fetch(url, {
28
    method: "POST",
29
    headers: {
30
      Authorization: auth.token,
31
    },
32
    body: undefined,
33
  });
34
  if (!response.ok) {
35
    const text = await response.text();
36
    throw new Error(`${response.status} ${text}`);
37
  }
38
  return await response.json();
39
}
40