POST
/
links
/
bulk
curl --request POST \
  --url https://api.dub.co/links/bulk?workspaceId={WORKSPACE_ID} \
  --header 'Authorization: Bearer {YOUR_TOKEN}' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "domain": "yourdomain.com",
      "url": "https://www.youtube.com/"
    },
    {
      "domain": "yourdomain.com",
      "url": "https://www.google.com/"
    }
    ...
  ]'
[
  {
    "id": "<string>",
    "domain": "<string>",
    "key": "<string>",
    "url": "<string>",
    "archived": false,
    "expiresAt": "<string>",
    "password": "<string>",
    "proxy": false,
    "title": "<string>",
    "description": "<string>",
    "image": "<string>",
    "rewrite": false,
    "ios": "<string>",
    "android": "<string>",
    "geo": {},
    "publicStats": false,
    "tagId": "<string>",
    "tags": [
      {
        "id": "<string>",
        "name": "<string>",
        "color": "red"
      }
    ],
    "comments": "<string>",
    "shortLink": "<string>",
    "qrCode": "<string>",
    "utm_source": "<string>",
    "utm_medium": "<string>",
    "utm_campaign": "<string>",
    "utm_term": "<string>",
    "utm_content": "<string>",
    "userId": "<string>",
    "workspaceId": "<string>",
    "clicks": 0,
    "lastClicked": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "projectId": "<string>"
  }
]

Bulk link creation does not support the following features: Link cloaking, Custom social media cards

curl --request POST \
  --url https://api.dub.co/links/bulk?workspaceId={WORKSPACE_ID} \
  --header 'Authorization: Bearer {YOUR_TOKEN}' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "domain": "yourdomain.com",
      "url": "https://www.youtube.com/"
    },
    {
      "domain": "yourdomain.com",
      "url": "https://www.google.com/"
    }
    ...
  ]'

Authorizations

​
Authorization
string
header
required

Default authentication mechanism

Query Parameters

​
workspaceId
string
required

The ID of the workspace to create the link for.

Body

application/json · object[]

The body is of type object[].

Response

200
application/json

The created links

The response is of type object[].