---
title: "UTM Builder"
method: POST
path: "/api/v1/tools/utm-builder"
tags: ["tools"]
---

# UTM Builder

`POST /api/v1/tools/utm-builder`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/utm-builder`
- Auth: HTTP bearer

Add utm_source, utm_medium, utm_campaign, utm_term and utm_content to a URL, keeping any query parameters it already has. Returns the tagged link plus warnings about upper case or missing required tags.

## Request body

- object
  - `url` string
  - `source` string
  - `medium` string
  - `campaign` string
  - `term` string
  - `content` string

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `url` string
    - `baseUrl` string
    - `params` object
      - `utm_source` string
      - `utm_medium` string
      - `utm_campaign` string
      - `utm_term` string
      - `utm_content` string
    - `warnings` unknown[]
      - unknown

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)