/v1/linksCreate links
Mint tracking links programmatically — one at a time, or five hundred in a transaction.
The Links API lives at /v1 and authenticates with a Links API key — Authorization: Bearer fk_live_…, minted on Dashboard → Links → API and shown exactly once. It's a separate surface from /api/v1; the gk_ key doesn't work here.
curl -X POST https://api.fictura.co/v1/links \
-H "Authorization: Bearer fk_live_..." \
-H "Content-Type: application/json" \
-d '{"name": "Spring drop", "destination_url": "https://apps.apple.com/app/id123", "slug": "springdrop"}'{
"ok": true,
"link": {
"id": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d",
"slug": "springdrop",
"name": "Spring drop",
"url": "https://api.fictura.co/l/springdrop",
"destination_url": "https://apps.apple.com/app/id123",
"link_type": "direct",
"provider": null,
"campaign_id": null,
"adset_id": null,
"ad_id": null,
"channel": null,
"keywords": null,
"site_id": null,
"is_retargeting": false,
"deep_link_value": null,
"click_lookback_days": 7,
"view_lookback_hours": 24,
"play_store_url": null,
"desktop_url": null,
"click_count": 0,
"impression_count": 0,
"created_at": "2026-10-01T09:14:03.120Z"
}
}name (1–120 characters) and destination_url (a URL, up to 1,000 characters) are the two required fields. slug is optional (one is generated) and must be 3–50 alphanumeric characters — no hyphens; a taken slug answers 409 slug_taken, a malformed body 400 invalid_body with an issues list. In the response, url is the short redirect (/l/<slug>) — the thing you put on the poster — and destination_url is where it points.
Optional fields
| Field | Limits |
|---|---|
provider | Up to 40 characters: lowercase letters, digits, _ . -. |
campaign_id, adset_id | Up to 200 characters. |
ad_id, keywords, sub1 to sub5 | Up to 100 characters. |
channel | Up to 20 characters. |
site_id | Up to 24 characters. |
is_retargeting | Boolean. Defaults to false. |
deep_link_value | Up to 200 characters. |
click_lookback_days | 1 to 30. Defaults to 7. |
view_lookback_hours | 1 to 24. Defaults to 24. |
play_store_url, og_image_url | A URL, up to 1,000 characters. |
desktop_url | A URL, up to 1,000 characters. Where a tap from a computer goes. Leave it out to send computers to your website from App identity when destination_url is a store page. |
og_title | Up to 40 characters. |
og_description | Up to 300 characters. |
The response does not echo sub1 to sub5 or the og_* fields. It adds click_count and impression_count.
Bulk
curl -X POST https://api.fictura.co/v1/links/bulk \
-H "Authorization: Bearer fk_live_..." \
-H "Content-Type: application/json" \
-d '{"links": [
{"name": "Creator A", "destination_url": "https://apps.apple.com/app/id123"},
{"name": "Creator B", "destination_url": "https://apps.apple.com/app/id123"}
]}'POST /v1/links/bulk takes 1–500 links and runs as one transaction — all created or none, answering 201 {"ok": true, "created": n, "links": […]}. One taken slug fails them all with 409 slug_taken. Beyond 500 is a 400 invalid_body, so split the batch.