Linkly - Atako

Let your agents manage your Linkly tracked links: list workspaces, domains and links, create or edit a link (slug, UTM, social preview), and read click statistics over time or by country, platform, referrer or UTM.

Connection

Authentication: API key (Linkly API token).

In Linkly (app.linklyhq.com): Settings → “API” → “API token” (Copy, or Renew to replace it). The key is account-level and reaches every workspace. Statistics calls count against the usage allowance of your plan: see linklyhq.com/support/analytics-api.See Linkly’s documentation.

Read actions (6)

Action	Description
`get_click_counters`	Click counts grouped by one dimension: {total, values: [{count, value}]} (top 10 000 values; total covers every group). Statistics calls count against the plan usage allowance (Free plan: 50 per hour and 100 per month). Arguments: workspace_id (string, required, from list_workspaces); counter (string, required: country, city, region, platform, destination, referer, bot_name, isp, link_id, remote_ip, top_params, ad_network, utm_source, utm_medium, utm_campaign, utm_content or utm_term); link_id (string) or link_ids (array of integer link ids); start and end (“YYYY-MM-DD”); country (ISO alpha-2 string); bots (boolean, false = exclude bots); unique (boolean). Always JSON.
`get_clicks`	Click time series of a workspace: {traffic: [{t, y}]}. Statistics calls count against the plan usage allowance (Free plan: 50 per hour and 100 per month): group the questions. Arguments: workspace_id (string, required, from list_workspaces); link_id (string, one link) or link_ids (array of integer link ids); start and end (“YYYY-MM-DD” or “YYYY-MM-DDTHH:MM:SSZ”); country (ISO alpha-2 string); browser, platform, referer, isp (strings); bots (boolean, false = exclude bots); unique (boolean, true = unique clicks only); timezone (string, e.g. “Europe/Paris”); frequency (“day” default or “hour”); pivot (“link_id” = one column per link). Always JSON.
`get_link`	Get one link: destination, short URL, UTM parameters, rules and configuration (no click counts: use get_clicks or list_links). Arguments: id (string, required, the link id from list_links); workspace_id (string, optional, from list_workspaces).
`list_domains`	List the custom domains of a workspace (usable as `domain` in save_link). Argument: workspace_id (string, required, from list_workspaces).
`list_links`	List the links of a workspace: {links, page_number, page_size, total_entries, total_pages, total_rows, workspace_link_count}, each link with its id, short URL and click totals. Arguments: workspace_id (string, required, from list_workspaces); search (string); page (integer, default 1); page_size (integer, default 1000); sort_by (string: any link column, or clicks_total, clicks_today, clicks_previous_day, clicks_thirty_days, human_clicks_total, human_clicks_thirty_days, human_clicks_today, human_clicks_previous_day); sort_dir (“asc” or “desc”); filters, each an exact match, ANDed: domain, slug, utm_source, utm_medium, utm_campaign, utm_content, utm_term (strings).
`list_workspaces`	List the workspaces the key can access: [{id, name}]. The workspace id is needed by list_links, get_clicks, get_click_counters, list_domains and save_link. Also used as the credential probe. No arguments.

Write actions (1)

Action	Description
`save_link`	Create a link, or update one when id is given. To create: url and workspace_id are required. To update: id (integer, from list_links) plus the fields to change. Arguments: url (string, destination); workspace_id (integer, from list_workspaces: the id as a number); id (integer); name, note, slug, domain (strings; domain from list_domains); utm_source, utm_medium, utm_campaign, utm_term, utm_content (strings); og_title, og_description, og_image (strings, social preview); enabled, block_bots, hide_referrer, forward_params, cloaking (booleans); expiry_datetime (ISO 8601 string); expiry_clicks (integer); expiry_destination (string, URL starting with http, where visitors go after expiry); rules (array of {what, matches, percentage, rule_url, url}, all strings). Returns the saved link with its short URL.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: October 2026.