UTM Codebook
Validate UTM parameters against your naming convention codebook. Catch errors before they break GA4 reports.
1 subscribers
13 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
UTM Codebook endpoints
| Method | Endpoint | Description |
|---|---|---|
| Validation | ||
| POST |
validateUrl /validate |
Validates UTM parameters in a URL against codebook rules. Returns pass/fail with structured errors and warnings per parameter. |
| POST |
validateBatch /validate/batch |
Validates up to 100 UTM-tagged URLs in a single request. Returns per-URL results and a summary with pass/fail/warning counts. |
| Codebooks | ||
| DELETE |
deleteCodebook /codebooks/{id} |
Soft-deletes a codebook. Can be restored via PUT /codebooks/{id}/restore. |
| POST |
createCodebook /codebooks |
Creates a new UTM naming convention codebook with parameter rules and global settings. GA4-recommended defaults are applied if parameters or global_rules are omitted. |
| PUT |
updateCodebook /codebooks/{id} |
Updates codebook name, description, parameter rules, or global settings. Creates a new version on each update. |
| GET |
listCodebooks /codebooks |
Returns all active codebooks in the workspace. Supports optional pagination. |
| PUT |
restoreCodebook /codebooks/{id}/restore |
Restores a soft-deleted codebook. Fails if restoring would exceed plan limit. |
| GET |
getCodebook /codebooks/{id} |
Returns full codebook including all parameter rules and global settings. |
| History | ||
| GET |
listValidations /validations |
Returns paginated validation history with optional filters. History retention depends on plan: Free 7 days, Starter 30 days, Growth 90 days. |
| Webhooks | ||
| POST |
createWebhook /webhooks |
Subscribes to events via HTTPS webhook. Max 5 per workspace. Payloads signed with HMAC-SHA256. |
| DELETE |
deleteWebhook /webhooks/{id} |
|
| GET |
listWebhooks /webhooks |
Returns all webhook subscriptions for the workspace. |
| Health | ||
| GET |
healthCheck /health |
Returns API status. No authentication required. |
UTM Codebook pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
