---
title: "Bulk Create Links"
method: POST
path: "/links/bulk"
tags: ["Links", "Bulk Operations"]
---

# Bulk Create Links

`POST /links/bulk`

## Request

- Base URL: `https://api.rebrandly.com/v1`
- URL: `https://api.rebrandly.com/v1/links/bulk`
- Auth: API key in header `apikey`

Create multiple links in a single request.

**Requires:**
- Feature: `links.bulk`
- Workspace type: Extended only

**Blocked by:** Revoked workspace.

**Limits:** Up to 10 links per request (configurable).

## Headers

- `Workspace` string
- `apikey` string, required

## Request body

- LinkInput[]
  - `destination` string, uri, required: Target URL where the link redirects
  - `slashtag` string: Custom URL path (auto-generated if not provided)
  - `domainId` string: Domain public ID to use for the link
  - `domain` object: Domain object (alternative to domainId)
    - `id` string
    - `fullName` string
  - `title` string: Human-readable title
  - `description` string: Link description (requires links.notes feature)
  - `tags` object[]: Tags to attach (max 5)
    - `id` string
  - `scripts` object[]: Scripts to attach (requires links.scripts feature)
    - `id` string
  - `ttl` integer: Time to live in seconds (requires links.expiration feature)
  - `password` string: Password protection (requires links.password feature)
  - `https` boolean: Enable HTTPS

## Response `200`

Bulk creation result

- object
  - `count` integer: Number of links created
  - `links` Link[]
    - `id` string, required: Link public ID (link_public_id)
    - `title` string: Human-readable title for the link
    - `slashtag` string, required: URL path component
    - `destination` string, uri, required: Target URL where the link redirects
    - `shortUrl` string, required: Complete short URL (domain + slashtag)
    - `domainId` string: Public ID of the domain used
    - `domainName` string: Full domain name
    - `domain` object: Domain object with details
      - `id` string
      - `ref` string
      - `fullName` string
      - `sharing` object
    - `clicks` integer: Number of clicks on the link
    - `createdAt` string, date-time, required: Timestamp when link was created
    - `updatedAt` string, date-time, required: Timestamp when link was last updated
    - `status` 'active' | 'deleted' | 'blocked', required: Link status
    - `description` string: Link description (only if links.notes feature is enabled)
    - `workspace` object: Workspace information
      - `id` string: Workspace public ID
    - `https` boolean: Whether the link supports HTTPS

## Other responses

- `403`: Feature not available or wrong workspace type

---

[API](https://skmtc.dev/rebrandly/apis/rebrandly-api.md) - [All operations](https://skmtc.dev/rebrandly/apis/rebrandly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rebrandly/apis/rebrandly-api/revisions/b098bf9fb684?raw)