Links
List tracked links
const url = 'https://app.whatsetter.com/api/v1/links?status=active&limit=25';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://app.whatsetter.com/api/v1/links?status=active&limit=25' \ --header 'Authorization: Bearer <token>'The workspace’s tracked WhatsApp links, newest first, with their
click counter and last click. Filter by campaign (document id or
slug) and status. Requires scope links:read.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Campaign document id or campaign_id slug.
Opaque cursor from the previous page’s pagination.next_cursor.
Responses
Section titled “Responses”The links
object
object
The public short link, https://app.whatsetter.com/l/<slug>.
The campaign slug the link routes to.
auto = the platform is read on each click (default); otherwise a forced platform (instagram, tiktok, …).
Click counter
object
Example
{ "data": [ { "id": "68d9aa11bb22cc33dd44ee55", "slug": "insta-bio", "name": "Instagram bio", "url": "https://app.whatsetter.com/l/insta-bio", "campaign_id": "auto24-maroc-4-bu76", "status": "active", "channel": "auto", "clicks": 128, "last_click_at": "2026-09-18T10:00:00.000Z", "created_at": "2026-09-01T08:00:00.000Z" } ], "pagination": { "has_more": false, "next_cursor": null }}Missing, unknown or revoked API key
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}Invalid parameter or body (also an invalid or expired cursor)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}