
UTM Link Builder API
Marketing
Create trackable marketing links with UTM parameters instantly. Monitor campaign performance and traffic sources for better marketing insights.
Authentication
All API requests require a valid API key passed in the Authorization header as a Bearer token.
Rate Limit
100 requests per minute
Endpoints
1 endpoint available
Overview
The UTM Link Builder API generates trackable marketing URLs with UTM parameters programmatically. Create campaign-specific links to monitor traffic sources and marketing performance in analytics platforms.
Features
- Append UTM parameters to any valid URL
- Supports all standard UTM parameters: source, medium, campaign, term, and content
- Automatic URL validation and parameter encoding
- Perfect for batch link generation and marketing automation
Use Cases
- Bulk generate campaign tracking links
- Automate marketing link creation in workflows
- Integrate UTM tagging into marketing platforms
- Create consistent tracking across email campaigns
Endpoints
POST
/v1/tools/utm-link-builderGenerate a URL with UTM parameters
Request Body
Content-Type: application/json
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Required | The destination URL to add UTM parameters to (must be a valid URL including protocol) |
| utm_source | string | Required | Identifies the source of traffic (e.g., google, newsletter, facebook, twitter) |
| utm_medium | string | Required | Identifies the marketing medium (e.g., cpc, banner, email, social, affiliate) |
| utm_campaign | string | Required | Name of the campaign (e.g., spring_sale, product_launch, black_friday) |
| utm_term | string | Optional | Used for paid search keywords (e.g., running+shoes, discount+code) |
| utm_content | string | Optional | Used to differentiate similar content or links (e.g., banner1, textlink, header_cta) |
Response Example
{
"success": true,
"data": {
"originalUrl": "https://example.com/products",
"generatedUrl": "https://example.com/products?utm_source=newsletter&utm_medium=email&utm_campaign=summer_sale&utm_content=header_banner",
"parameters": {
"utm_source": "newsletter",
"utm_medium": "email",
"utm_campaign": "summer_sale",
"utm_content": "header_banner"
}
}
}Error Codes
400
Bad Request - Invalid URL format or missing required UTM parameters401
Unauthorized - Invalid or missing API key429
Too Many Requests - Rate limit exceeded500
Internal Server ErrorCode Examples
curl -X POST https://api.opentools.ca/v1/tools/utm-link-builder \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/products",
"utm_source": "newsletter",
"utm_medium": "email",
"utm_campaign": "summer_sale",
"utm_content": "header_banner"
}'