API Docs

v1.0

Get API Key

Developers/Integrations/Zapier

Zapier Integration

Connect TrimLink to 5,000+ apps and automate your link management workflows with Zapier.

Getting Started

Create an API Key

Go to Dashboard → Settings → API & Integrations and create an API key with links:read and links:write scopes.

Connect TrimLink in Zapier

In Zapier, search for “TrimLink” and select it. When prompted, enter your API key to authenticate.

Build Your Zap

Choose a trigger (e.g., Link Clicked) or action (e.g., Create Link) and configure your workflow.

Authentication

Zapier uses your TrimLink API key for authentication. The key is passed in the Authorization header:

Authentication Header

Authorization: Bearer tk_live_your_api_key

Required Scopes: Your API key needs links:read for triggers and links:write for actions.

Available Triggers

Triggers start your Zaps when events occur in TrimLink:

New Link Created

Fires when a new link is created in your TrimLink account

link.created

Available data:

Link IDShort codeShort URLDestination URLTitleCreated timestamp

Link Clicked

Fires when someone clicks one of your links

link.clicked

Available data:

Link IDShort codeClick timestampReferrerCountryDeviceBrowser

Link Updated

Fires when a link is modified

link.updated

Available data:

Link IDShort codeUpdated fieldsUpdated timestamp

Link Deleted

Fires when a link is deleted

link.deleted

Available data:

Link IDShort codeDeleted timestamp

Available Actions

Actions let you create or modify TrimLink data from other apps:

Create Link

Create a new shortened link

Input Fields:

Field	Required	Description
`url`	Yes	Destination URL to shorten
`customCode`	No	Custom short code
`title`	No	Link title
`description`	No	Link description

Output data:

Link IDShort codeShort URLOriginal URLCreated timestamp

Example Workflows

Popular Zaps you can create with TrimLink:

Log clicks to Google Sheets

Trigger: Link Clicked → Action: Add row to Google Sheets

Track all link clicks in a spreadsheet for analysis and reporting.

Notify Slack on new links

Trigger: Link Created → Action: Send Slack message

Get notified in your team channel whenever a new link is created.

Auto-shorten links from forms

Trigger: Typeform submission → Action: Create TrimLink

Automatically create short links from URLs submitted through forms.

Add high-click links to Notion

Trigger: Link Clicked + Filter → Action: Create Notion page

Use Zapier filters to create Notion entries only for links exceeding click thresholds.

Trigger Payload Format

When a trigger fires, TrimLink sends data in this format:

link.clicked payload

{
  "event": "link.clicked",
  "timestamp": "2026-01-31T12:00:00Z",
  "data": {
    "linkId": "clx123abc",
    "shortCode": "my-link",
    "shortUrl": "https://trimlink.co/my-link",
    "destinationUrl": "https://example.com/page",
    "clickedAt": "2026-01-31T12:00:00Z",
    "referrer": "https://twitter.com",
    "country": "US",
    "device": "mobile",
    "browser": "Chrome"
  }
}

Troubleshooting

Authentication failed: Verify your API key is correct and hasn't been revoked. Check that it has the required scopes.
Triggers not firing: Ensure your webhook subscription is active in the API settings. Try re-authenticating the connection in Zapier.
Action errors: Check that all required fields are provided and the URL format is valid. Review the error message for specific details.
Rate limits: Zapier actions count toward your API rate limit. See Rate Limits for details.