Skip to content
xengo docs

Bulk create

POST /v1/links/bulk — scope links:write

Create many links in one call — campaign batches, per-recipient links, label runs. Up to 500 rows per request; monthly row caps by plan (Pro 1,000, Business 10,000). Rows skip the metadata scrape for speed.

Terminal window
curl -X POST https://api.neon.xengo.io/v1/links/bulk \
  -H "Authorization: Bearer $XENGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rows": [
      { "destination": "https://acme.com/store/leeds",  "code": "leeds",  "tags": { "site": "leeds" } },
      { "destination": "https://acme.com/store/york",   "code": "york",   "tags": { "site": "york" } },
      { "destination": "https://acme.com/store/leeds2" }
    ]
  }'

The response reports per-row outcomes, so a bad row doesn’t fail the batch:

{
  "created": 3,
  "failed": 0,
  "links": [
    { "code": "leeds", "shortUrl": "https://go.acme.com/leeds" },
    { "code": "york",  "shortUrl": "https://go.acme.com/york" },
    { "code": "k3x9m2a", "shortUrl": "https://go.acme.com/k3x9m2a" }
  ]
}