Skip to main content
POST
https://api.bouncy.ai
/
v1
/
links
/
bulk
curl -X POST https://api.bouncy.ai/v1/links/bulk \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "links": [
      {
        "url": "https://example.com/page1",
        "slug": "page1",
        "title": "Page 1",
        "tags": ["bulk", "test"]
      },
      {
        "url": "https://example.com/page2",
        "slug": "page2",
        "title": "Page 2",
        "tags": ["bulk", "test"]
      },
      {
        "url": "https://example.com/page3",
        "slug": "page3",
        "title": "Page 3",
        "tags": ["bulk", "test"]
      }
    ]
  }'

{
  "created": [
    {
      "id": "link_abc123",
      "shortUrl": "https://bouncy.link/page1",
      "slug": "page1",
      "destination": "https://example.com/page1",
      "title": "Page 1",
      "tags": ["bulk", "test"]
    },
    {
      "id": "link_def456",
      "shortUrl": "https://bouncy.link/page2",
      "slug": "page2",
      "destination": "https://example.com/page2",
      "title": "Page 2",
      "tags": ["bulk", "test"]
    }
  ],
  "failed": [
    {
      "index": 2,
      "slug": "page3",
      "error": {
        "code": "slug_already_exists",
        "message": "The slug 'page3' is already in use"
      }
    }
  ],
  "summary": {
    "total": 3,
    "succeeded": 2,
    "failed": 1
  }
}

​
Request

​
Headers

​
X-Api-Key
string
required
Your API key (e.g., bcy_live_pk_YOUR_API_KEY)
​
Content-Type
string
required
Must be application/json

​
Body

​
links
array
required
Array of link objects to create (max: 100)Each link object can contain the same fields as the single create endpoint:
  • url (required) - Destination URL
  • slug (optional) - Custom slug
  • title (optional) - Link title
  • description (optional) - Link description
  • tags (optional) - Array of tags
  • domain (optional) - Custom domain

​
Response

​
created
array
Array of successfully created link objects
​
failed
array
Array of failed link attempts with error details
​
summary
object
Summary counts
curl -X POST https://api.bouncy.ai/v1/links/bulk \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "links": [
      {
        "url": "https://example.com/page1",
        "slug": "page1",
        "title": "Page 1",
        "tags": ["bulk", "test"]
      },
      {
        "url": "https://example.com/page2",
        "slug": "page2",
        "title": "Page 2",
        "tags": ["bulk", "test"]
      },
      {
        "url": "https://example.com/page3",
        "slug": "page3",
        "title": "Page 3",
        "tags": ["bulk", "test"]
      }
    ]
  }'

{
  "created": [
    {
      "id": "link_abc123",
      "shortUrl": "https://bouncy.link/page1",
      "slug": "page1",
      "destination": "https://example.com/page1",
      "title": "Page 1",
      "tags": ["bulk", "test"]
    },
    {
      "id": "link_def456",
      "shortUrl": "https://bouncy.link/page2",
      "slug": "page2",
      "destination": "https://example.com/page2",
      "title": "Page 2",
      "tags": ["bulk", "test"]
    }
  ],
  "failed": [
    {
      "index": 2,
      "slug": "page3",
      "error": {
        "code": "slug_already_exists",
        "message": "The slug 'page3' is already in use"
      }
    }
  ],
  "summary": {
    "total": 3,
    "succeeded": 2,
    "failed": 1
  }
}