---
updatedAt: 2025-11-05T21:12:38.000Z
agentTools:
  projectIndex: https://developers.short.io/llms.txt
---

# Create up to 1000 links in one call

Please use this method if you need to create big packs of links. It
accepts up to 1000 links in one API call.

It works almost the same as single link creation endpoint, but accepts
an array of URLs and returns an array of responses.

Returns list of Link objects. If any URL is failed to insert, it returns
error object instead as array element. Method is not transactional – it
can insert some links from the list and return an error for others.

**Rate limit**: 5 queries in 10 seconds

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Short.io API",
    "version": "1.0.0"
  },
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "paths": {
    "/links/bulk": {
      "post": {
        "summary": "Create up to 1000 links in one call",
        "tags": [
          "Link Management"
        ],
        "description": "Please use this method if you need to create big packs of links. It\naccepts up to 1000 links in one API call.\n\nIt works almost the same as single link creation endpoint, but accepts\nan array of URLs and returns an array of responses.\n\nReturns list of Link objects. If any URL is failed to insert, it returns\nerror object instead as array element. Method is not transactional – it\ncan insert some links from the list and return an error for others.\n\n**Rate limit**: 5 queries in 10 seconds",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "format": "hostname",
                    "type": "string"
                  },
                  "allowDuplicates": {
                    "default": false,
                    "type": "boolean"
                  },
                  "links": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "allowDuplicates": {
                          "type": "boolean"
                        },
                        "originalURL": {
                          "description": "Original URL",
                          "type": "string",
                          "example": "https://example.com"
                        },
                        "cloaking": {
                          "description": "Cloaking",
                          "type": "boolean"
                        },
                        "password": {
                          "description": "Link password",
                          "type": "string",
                          "example": "s3cur3p@ssw0rd"
                        },
                        "redirectType": {
                          "enum": [
                            301,
                            302,
                            307,
                            308
                          ],
                          "description": "HTTP code for redirect",
                          "nullable": true,
                          "type": "integer",
                          "example": 301
                        },
                        "expiresAt": {
                          "description": "Link expiration date in milliseconds or ISO string",
                          "anyOf": [
                            {
                              "nullable": true,
                              "type": "integer"
                            },
                            {
                              "format": "iso-date-time",
                              "nullable": true,
                              "type": "string"
                            }
                          ],
                          "example": "2024-11-07T16:55:22.307Z"
                        },
                        "expiredURL": {
                          "nullable": true,
                          "description": "Expired URL",
                          "type": "string",
                          "example": "https://example.com/expired"
                        },
                        "title": {
                          "description": "Link title",
                          "type": "string"
                        },
                        "tags": {
                          "description": "Array of link tags",
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "utmSource": {
                          "description": "set utm_source parameter to destination link",
                          "type": "string",
                          "example": "cpc"
                        },
                        "utmMedium": {
                          "description": "set utm_medium parameter to destination link",
                          "type": "string",
                          "example": "banner"
                        },
                        "utmCampaign": {
                          "description": "set utm_campaign parameter to destination link",
                          "type": "string",
                          "example": "summer_sale"
                        },
                        "utmTerm": {
                          "description": "set utm_term parameter to destination link",
                          "type": "string",
                          "example": "running_shoes"
                        },
                        "utmContent": {
                          "description": "set utm_content parameter to destination link",
                          "type": "string",
                          "example": "cta_button"
                        },
                        "ttl": {
                          "description": "Time to live in milliseconds or ISO string",
                          "anyOf": [
                            {
                              "format": "iso-date-time",
                              "nullable": true,
                              "type": "string"
                            },
                            {
                              "nullable": true,
                              "type": "integer"
                            }
                          ],
                          "example": "2024-11-07T16:55:22.307Z"
                        },
                        "path": {
                          "nullable": true,
                          "description": "Link slug",
                          "type": "string",
                          "example": "my-link"
                        },
                        "androidURL": {
                          "description": "Android URL",
                          "nullable": true,
                          "type": "string",
                          "example": "https://play.google.com/store/apps/details?id=com.example.app"
                        },
                        "iphoneURL": {
                          "description": "iPhone URL",
                          "nullable": true,
                          "type": "string",
                          "example": "https://apps.apple.com/us/app/example-app/id1234567890"
                        },
                        "createdAt": {
                          "description": "Link creation date in milliseconds",
                          "anyOf": [
                            {
                              "nullable": true,
                              "examples": [
                                1730998522307
                              ],
                              "type": "integer"
                            },
                            {
                              "format": "iso-date-time",
                              "nullable": true,
                              "type": "string"
                            }
                          ],
                          "example": "2024-11-07T16:55:22.307Z"
                        },
                        "clicksLimit": {
                          "nullable": true,
                          "minimum": 1,
                          "description": "disable link after specified number of clicks",
                          "type": "integer",
                          "example": 100
                        },
                        "passwordContact": {
                          "description": "Provide your email to users to get a password",
                          "nullable": true,
                          "type": "boolean"
                        },
                        "skipQS": {
                          "description": "Skip query string merging",
                          "default": false,
                          "type": "boolean"
                        },
                        "archived": {
                          "description": "Link is archived",
                          "default": false,
                          "type": "boolean"
                        },
                        "splitURL": {
                          "description": "Split URL",
                          "nullable": true,
                          "type": "string",
                          "example": "https://example.com/split"
                        },
                        "splitPercent": {
                          "nullable": true,
                          "minimum": 1,
                          "maximum": 100,
                          "description": "Split URL percentage",
                          "type": "integer",
                          "example": 50
                        },
                        "integrationAdroll": {
                          "description": "Adroll integration",
                          "nullable": true,
                          "type": "string"
                        },
                        "integrationFB": {
                          "description": "Facebook integration",
                          "nullable": true,
                          "type": "string"
                        },
                        "integrationGA": {
                          "description": "Google Analytics integration",
                          "nullable": true,
                          "type": "string"
                        },
                        "integrationGTM": {
                          "description": "Google Tag Manager integration",
                          "nullable": true,
                          "type": "string"
                        }
                      },
                      "required": [
                        "originalURL"
                      ]
                    }
                  },
                  "folderId": {
                    "description": "Folder ID",
                    "type": "string"
                  }
                },
                "required": [
                  "domain",
                  "links"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Default Response"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.short.io",
      "description": "API server"
    }
  ],
  "security": [
    {
      "apiKey": []
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```