Linkly integration: operations for AI agents
Linkly connects to Type.com as an integration. This page lists the 26 operations documented for Claude and Codex in Type.com: 11 read, 10 write, 5 destructive.
About Linkly
Easily create tracking links, add retargeting tags, do smart redirects and more.
Categories: Marketing & Social
How to connect Linkly to Type.com
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
26 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
26 operations listed.
Conversions
- Read
List conversions
List the workspace's conversions. Without after or since, returns the most recent conversions first (by occurredat). Paging through every conversion Pass since, after, or both, and conversions come back in the order Linkly recorded them, oldest first.
- Write
Report a conversion
Report a conversion — a purchase, signup, or custom event that happened on your site after someone clicked a Linkly link. Pass the linklycid your landing page captured to attribute the conversion to the originating link.
Domains
- Read
List domains
Get all custom domains configured for a workspace. These domains can be used when creating short links.
- Write
Add a custom domain
Add a new custom domain to your workspace. You must configure a CNAME DNS record pointing to domains.linklyhq.com before adding the domain.
- Write
Create domain in workspace
Add a new custom domain to a specific workspace. You must configure a CNAME DNS record pointing to domains.linklyhq.com before adding the domain.
- Write
Update domain favicon
Update the favicon URL for a custom domain.
- Destructive
Delete a domain
Remove a custom domain from your workspace. Links using this domain will no longer work.
Links
- Read
Get link details
Retrieve details for a specific link by ID.
- Read
Get link details
Retrieve a specific link by its ID: destination, short URL, UTM parameters, rules and configuration. Click counts are not included — use getClicks for a time series, or listLinks for per-link totals.
- Read
Export links
Export all links in a workspace as JSON or CSV.
- Read
List links
Get a paginated list of all links in a workspace. Supports search, sorting, and pagination. Returns link details including click statistics.
- Write
Create or update a link
Create a new shortened link or update an existing one. To create: provide url and workspaceid. To update: provide id and any fields to change. Supports custom slugs, UTM parameters, retargeting pixels, Open Graph metadata, and redirect rules.
- Write
Create or update multiple links
Create or update up to 1000 links in one request. The body is a JSON array where each item uses the same schema as POST /api/v1/link — include id to update, omit it to create, and provide workspaceid per item (required for API-key auth; ignored for OAuth, whose token is scoped t…
- Write
Create or update a link
Create a new link or update an existing one. Include an 'id' field to update an existing link. Can also accept an array of links for batch operations.
- Write
Restore links
Restore one or more soft-deleted links by their IDs. Reconstructs each link's short URL (domain/slug) from its preserved fullurl. Links whose short URL is now taken by a live link are skipped and reported under conflicts.
- Destructive
Delete links
Delete one or more links by their IDs. Deleted links are moved to the workspace's trash and can be restored with restoreLinks.
- Destructive
Delete a single link
Delete a specific link by ID. The link is moved to the workspace's trash and can be restored with restoreLinks. Deleting a link that is already in the trash is a no-op and still returns 200; an id that does not exist in the workspace returns 404.
Webhooks
- Read
List webhooks for a link
Get all webhook subscriptions for a specific link.
- Read
List webhooks for a workspace
Get all webhook subscriptions for a specific workspace.
- Write
Subscribe webhook to a link
Subscribe a webhook URL to receive events for a specific link. The endpoint receives a POST for each click, plus link.updated and link.deleted for this link. Branch on the JSON event field; see the Webhooks section for payload shapes.
- Write
Subscribe webhook to a workspace
Subscribe a webhook URL to receive events for every link in the workspace. A new subscription receives a POST for each click, link.created, link.updated, and link.deleted; the events can be narrowed per URL in the workspace settings.
- Destructive
Unsubscribe webhook from a link
Remove a webhook subscription from a link. The hookid is the URL-encoded webhook URL.
- Destructive
Unsubscribe webhook from a workspace
Remove a webhook subscription from a workspace. The hookid is the URL-encoded webhook URL.
Clicks
- Read
Get click analytics
Retrieve click analytics for a workspace. Filter by link, date range, country, and more. Returns time-series data suitable for charting.
- Read
Get click counts grouped by dimension
Retrieve click analytics grouped by a specific dimension (counter). Returns aggregated counts for each unique value of the selected dimension, ordered by count descending. A maximum of 10,000 values are returned.
Workspaces
- Read
List user workspaces
Returns a list of all workspaces the authenticated user has access to. Use this to discover available workspace IDs for other API calls.
No operations match.
See How connections work for access and permissions, or browse all integrations.