---
title: "Add a go link"
method: POST
path: "/organizations/{organizationId}/goLinks"
tags: ["Go Links"]
---

# Add a go link

`POST /organizations/{organizationId}/goLinks`

Adds a new go link for the organization.

## Path parameters

- `organizationId` string, required

## Request body

- AddGoLinkRequest — Payload for creating a Go Link
  - `name` string, required — The name of the Go Link that comes after go/. Only alphanumeric characters, dashes, and underscores are allowed.
  - `destinationUrl` string, required — The URL that the Go Link redirects to.
  - `description` string — Optional description for the Go Link.
  - `urlPattern` string, nullable — Optional destination URL with {*} placeholders for variables to be inserted. Variables are specified like go/<name>/<var1>/<var2>.
  - `creatorEmail` string, nullable — Optional creator email for the Go Link. Only organization admins can set this field.

## Response `200`

Confirmation that the go link was added.

- AddGoLinkResult — The result of adding a Go Link.

## Other responses

- `400` — The request parameters did not conform to expectations.
- `403` — The API token does not grant access to this resource.

---

[API](https://skmtc.net/coda/apis/superhuman-docs-api.md) · [All operations](https://skmtc.net/coda/apis/superhuman-docs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coda/superhuman-docs-api/revisions/22273737ad50/schema)