Link Management

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.

Returns 404 if the domain does not exist in your organization.

Rate limit: 5 queries in 10 seconds

post/links/bulk

Request

  • Base URL: https://api.short.io
  • URL: https://api.short.io/links/bulk
  • Auth: API key in header Authorization

Request body

domainstring hostname required

Domain hostname

allowDuplicatesboolean

Allow duplicate destinations across the batch

folderIdstring

Folder ID

Example request

{
  "domain": "short.io",
  "links": [
    {
      "originalURL": "https://example.com",
      "password": "s3cur3p@ssw0rd",
      "redirectType": 301,
      "expiredURL": "https://example.com/expired",
      "utmSource": "cpc",
      "utmMedium": "banner",
      "utmCampaign": "summer_sale",
      "utmTerm": "running_shoes",
      "utmContent": "cta_button",
      "path": "my-link",
      "androidURL": "https://play.google.com/store/apps/details?id=com.example.app",
      "iphoneURL": "https://apps.apple.com/us/app/example-app/id1234567890",
      "createdAt": 1792410647630,
      "clicksLimit": 100,
      "splitURL": "https://example.com/split",
      "splitPercent": 50
    }
  ]
}

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.