Bulk Link Creation

API for creating multiple short links at once.
If you need bulk creation, you can also use the [Bulk Link Creation] menu in the dashboard.

The maximum number of links that can be created at once by plan is:

  • Personal plan: up to 100
  • Premium plan: up to 200
  • Business plan: up to 300

If you need more links, call this API multiple times.
This API is available on Personal plans and above.

POST

/api/link/v1/createBulk 

{
    "links": [
        {
            "url": "https://google.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://facebook.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://twitter.com",
            "domain": "https://vvd.bz"
        }
    ]
}

Request Parameters

linksarrayrequired
An array containing multiple links. Each item has the same structure as the Create API.
urlstringrequired
Original URL.
Up to 3,000 bytes allowed.
domainstringrequired
Default:https://vvd.bz
Link domain.
If “brandLinkId” is set to Y, the domain will be https://vvd.im.
You can also use a custom domain.
redirectTypeinteger
Default:302
Enum:
200301302
Redirect type.
See Terminology for details.
This feature is available on Personal plans and above.
grpIdxinteger
Used to group links.
Group IDX can be found via the Link Group List API or in the dashboard.
brandLinkIdstring
If not set, the link ID is automatically generated by the system.
Without a custom domain, the default link domain is https://vvd.im.
Example: https://vvd.im/[brandLinkId]
ttlstring
Link title. If not specified, the webpage title of the original URL is used.
For faster creation, set this value directly to skip parsing.
descriptionstring
When redirectType is 200, the description meta tag can be set.
metaImgstring
When redirectType is 200, the image meta tag can be set.
Image URLs must start with https://.
memostring
Notes for link management.
notfSubscYnstring
Default:N
Enum:
YN
Push subscription link.
If set to Y, a landing page opens before redirecting, asking the user for push permission.
If denied or canceled, the user is sent directly to the original URL.
pushNotifyYnstring
Default:N
Enum:
YN
Push notifications for clicks.
If Y, alerts are sent to devices with the Vivoldi app when the set click count is reached (configured in Dashboard → Settings).
This feature is available on Personal plans and above.
mailNotifyYnstring
Default:N
Enum:
YN
Email notifications for clicks.
If Y, email alerts are sent when the set click count is reached (configured in Dashboard → Settings).
This feature is available on Personal plans and above.
delYmdtdatetime
Scheduled link deletion date.
After this date, the link is automatically deleted.
Example: 2025-08-30 23:59:59 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "shortUrl": "https://vvd.bz/bbuR",
            "url": "https://google.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuS",
            "url": "https://facebook.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuT",
            "url": "https://twitter.com"
        }
    ]
}

Response Parameters

codeinteger
Response code: 0 = Success, other values = Error
messagestring
Response message. If the response code is not 0, an error message is returned.
resultarray
Response data. The requested number of short URLs are returned in an array.