---
updatedAt: 2026-06-18T05:56:27.000Z
agentTools:
  projectIndex: https://developers.rebrandly.com/llms.txt
---

# Create multiple links with the same destination URL

A dedicated endpoint for creating large numbers of links with the same destination URL. Available on specific subscriptions.

## Speed

This endpoint allows you to create up to 100,000 links per second.

## Extended workspace

This endpoint can be used only in extended workspaces. See [here](https://developers.rebrandly.com/docs/get-started) how to define the workspace in your API request.

## Dedicated endpoint

You will be provided with a dedicated endpoint for using this method.

In this guide, we will use a generic `<DEDICATED_ENDPOINT_URL>`that you will need to replace in order to use this API

Links can be created via:

* a `PUT` HTTP request to `<DEDICATED_ENDPOINT_URL>/v1/links/bulk`, with body parameters defined in the next paragraph

## Body Parameters

Table below shows the parameters you should specify when creating a Link:

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th>
        Link property
      </th>

      <th>
        Type
      </th>

      <th>
        Constraints
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        destination
      </td>

      <td>
        string
      </td>

      <td>
        **required**\
        UTF8\
        Valid URL\
        Max 2048 chars
      </td>

      <td>
        The destination URL you want your branded short link to point to
      </td>
    </tr>

    <tr>
      <td>
        count
      </td>

      <td>
        integer
      </td>

      <td>
        **required**\
        Positive integer\
        Min value 1\
        Max value 50,000
      </td>

      <td>
        Number of links to be created
      </td>
    </tr>

    <tr>
      <td>
        domainId
      </td>

      <td>
        string
      </td>

      <td>
        **required**\
        Domain Id
      </td>

      <td>
        Domain to use to create the short links
      </td>
    </tr>

    <tr>
      <td>
        ttl
      </td>

      <td>
        integer
      </td>

      <td>
        *optional*\
        Min value 3600
      </td>

      <td>
        Time-to-live for the link, in seconds. If not provided, the value defaults to your plan's maximum TTL (90 days on most plans).

        The value is capped at your plan's `maxTTL`. If the value you provide exceeds the cap, it is silently reduced and the response includes `ttlCapped: true`.
      </td>
    </tr>
  </tbody>
</Table>

## Auto-generation strategy for slashtags

The logic for auto-generation `slashtag` can be found [here](https://developers.rebrandly.com/docs/create-a-new-link), using this endpoint the length of the slashtag will start from 5 characters

Examples of valid Link object to `PUT`:

```json Custom TTL
{
  "destination": "https://rebrandly.com/api-solutions",
  "domainId": "abc123xyz",
  "count": 12000,
  "ttl": 86400
}
```
```Text Default TTL
{
  "destination": "https://rebrandly.com/api-solutions",
  "domainId": "abc123xyz",
  "count": 12000
}
```

```curl cURL PUT
$ curl '\<DEDICATED_ENDPOINT_URL>/v1/links/bulk' \
-X POST \
-H 'apikey: YOUR_API_KEY' \
-H 'workspace: YOUR_WORKSPACE_ID' \
-H 'Content-Type: application/json' \
-d \
'{
  "destination": "https://rebrandly.com/api-solutions",
  "domainId": "abc123xyz",
  "count": 12000,
  "ttl": 86400
}'
// slashtag and title are optional
```

```json JSON Response (TTL within plan limit)
{
   "links":[
      {
         "id":"abc123xyz",
         "shortUrl":"rebrandly.com/abc12",
         "slashtag":"abc12",
         "destination":"https://rebrandly.com/api-solutions",
         "ttl":3600,
         "expiresAt":1726481918,
         "ttlCapped":null
      }
   ],
   "count":1
}
```

When the requested `ttl` exceeds your plan's maximum, the value is clamped and `ttlCapped` is returned with details:

```json JSON Response (TTL clamped)
{
   "links":[
      {
         "id":"abc123xyz",
         "shortUrl":"rebrandly.com/abc12",
         "slashtag":"abc12",
         "destination":"https://rebrandly.com/api-solutions",
         "ttl":7776000,
         "expiresAt":1726481918,
         "ttlCapped":{
            "requestedValue":31536000,
            "appliedValue":7776000,
            "reason":"plan_max_exceeded"
         }
      }
   ],
   "count":1
}
```

```json JSON Response (TTL capped to plan limit)
{
   "links":[
      {
         "id":"abc123xyz",
         "shortUrl":"rebrandly.com/abc12",
         "slashtag":"abc12",
         "destination":"https://rebrandly.com/api-solutions",
         "ttl":7776000,
         "expiresAt":1734257918
      }
   ],
   "count":1,
   "ttlCapped":true
}
```

<br />

## Handling errors

| HTTP Status | Error type                                            | Description                                                                                                                  |
| :---------- | :---------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |
| 403         | [403 - Already exists](https://developers.rebrandly.com/docs/403-already-exists-errors) | Given pair of slashtag and domain forms a branded short link which already exists. Either change the domain or the slashtag. |
| 403         | [403 - Invalid format](https://developers.rebrandly.com/docs/validation-errors)         | Invalid Link object. Double check value for `property` field. Details about validation failure in `message` field.           |