Campaigns

Group links under named campaigns for reporting, organization, and bulk operations in the dashboard and API.

What campaigns are

A campaign is a container for related short links—think seasonal promos, influencer drops, or paid media flights. Campaigns help you filter analytics, compare performance, and keep the link list manageable as you scale.

How to create a campaign in the dashboard

1. Open your project in the Flinku dashboard.
2. Go to Campaigns (or the equivalent section in your workspace).
3. Click New campaign.
4. Enter a name, optional description, and date range if your workflow uses one.
5. Save the campaign. It appears in the campaign picker when creating or editing links.

How to assign links to campaigns

• When creating a link, choose the campaign from the dropdown (or multi-select if supported).
• To move existing links, open the link editor and update the campaign assignment.
• Links without a campaign still work; assignment is optional but recommended for attribution.

API

Authenticate with a Firebase ID token or API key (Authorization: Bearer …).

List campaigns

GET /api/campaigns?projectId=YOUR_PROJECT_ID
Authorization: Bearer YOUR_TOKEN_OR_API_KEY

// Example response
[
  {
    "id": "camp_abc123",
    "name": "Summer 2026",
    "projectId": "YOUR_PROJECT_ID",
    "createdAt": "2026-01-15T10:00:00.000Z"
  }
]

Create campaign

POST /api/campaigns
Authorization: Bearer YOUR_TOKEN_OR_API_KEY
Content-Type: application/json

{
  "projectId": "YOUR_PROJECT_ID",
  "name": "Spring Launch",
  "description": "EU + US paid social"
}