POST/api/v1/links/bulk

Bulk import links

Create multiple links in a single request. Useful for migrations or seeding large campaign batches. Rate limited to 3 requests per minute.

Authorization

Authorizationstringheaderrequired

Bearer token. Format: Bearer YOUR_API_KEY

Bodyapplication/json

domainstringbodyrequired

Domain for all links in this batch. Must be a domain verified in your workspace (e.g. go.mycompany.com).

linksarraybodyrequired

Array of link objects to create. Each object supports the fields below.

links[].urlstringbodyrequired

The destination URL for this link.

links[].customSlugstringbodyoptional

Custom slug. Auto-generated if omitted.

links[].titlestringbodyoptional

Display name for the link.

links[].redirectTypePERMANENT_301 | TEMPORARY_302bodyoptional

HTTP redirect type. Defaults to TEMPORARY_302.

curl -X POST https://app.brevr.io/api/v1/links/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "domain": "go.mycompany.com",
  "links": [
    {"url": "https://example.com/a", "customSlug": "link-a", "title": "Link A"},
    {"url": "https://example.com/b", "customSlug": "link-b", "title": "Link B"},
    {"url": "https://example.com/c", "title": "Link C"}
  ]
}'

{
"created": 3,
"activeCount": 3,
"pendingCount": 0,
"failed": [],
"links": [
  {
    "id": "clx1abc2def3ghi4",
    "shortCode": "link-a",
    "url": "https://example.com/a",
    "domain": "go.mycompany.com",
    "pendingVerification": false
  },
  ...
]
}