Bulk import (CSV)

Create hundreds of links at once from a spreadsheet.

CSV template

Download the template from the dashboard Links → Import CSV. The first row must be column headers matching the field names below.

Columns

Required

title

Optional

deepLink
slug
params (JSON string)
utmSource, utmMedium, utmCampaign
tags (comma-separated)
campaignId
influencerId

Maximum 400 rows and 1MB per upload.

API

bash

POST /api/links/bulk-csv
Content-Type: multipart/form-data
Authorization: Bearer YOUR_TOKEN_OR_API_KEY
 
Fields:
  file: (CSV)
  projectId: YOUR_PROJECT_ID

javascript

// Response
{
  "created": 120,
  "skipped": 3,
  "errors": [{ "row": 45, "message": "Invalid slug" }],
  "links": [/* created link summaries */]
}