---
title: "Create multiple links in one request"
method: POST
path: "/api/v1/links/bulk"
tags: ["Links"]
---

# Create multiple links in one request

`POST /api/v1/links/bulk`

## Request

- Base URL: `https://workers.miniurl.com`
- URL: `https://workers.miniurl.com/api/v1/links/bulk`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- BulkCreateRequest
  - `links` ShortenRequest[], required
    - `url` string, uri, required
    - `alias` string: 4-64 characters on miniurl.com; 1-64 characters on a verified custom domain.
    - `domain` string
    - `password` string
    - `expiration` string, date-time
    - `activated_at` string, date-time
    - `dry_run` boolean: OAuth Agent only: validate policy, safety, alias, and domain availability without creating the link.

## Response `200`

Bulk creation processed

- BulkCreateResponse
  - `success` boolean, required
  - `data` object, required
    - `results` object[], required
    - `summary` object, required
      - `total` integer, required
      - `succeeded` integer, required
      - `failed` integer, required

## Other responses

- `400`: Invalid input or malformed JSON
- `401`: Missing, invalid, expired, or wrong bearer token for this endpoint
- `429`: Rate limit, token quota, or plan quota exceeded

---

[API](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api.md) · [All operations](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/llms.txt) · [OpenAPI document](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/revisions/1d12196927db?raw)