---
title: "/v1/links"
method: POST
path: "/v1/links"
tags: ["Links"]
---

# /v1/links

`POST /v1/links`

Create a new link

## Headers

- `workspace` string

## Request body

- LinkCreationRequest
  - `destination` string, required — The destination URL you want your branded short link to point to. Example: https://google.com
  - `slashtag` string — The keyword portion of your branded short link. A random one (as short as possible according to the branded domain you use) will be auto-generated if you do not specify one.
  - `domain` object — A reference to the Branded Domain resource for this branded short link. Specify either domain id or domain fullName or both. Make sure the domain is already active/verified and shared in this workspace.
    - `id` string — Branded domain's unique identifier
    - `fullName` string — Branded domain's FQDN
  - `title` string — A title you assign to the branded short link in order to remember what's behind it. A random title will be assigned to the link if you do not specify one.

## Response `200`

200

- Link
  - `id` string
  - `title` string
  - `slashtag` string
  - `destination` string
  - `createdAt` string
  - `updatedAt` string
  - `shortUrl` string
  - `domain` object
    - `id` string
    - `fullName` string

## Other responses

- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/rebrandly/apis/rebrandly-legacy.md) · [All operations](https://skmtc.net/rebrandly/apis/rebrandly-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rebrandly/rebrandly-legacy/revisions/edc8d2ea0d88/schema)