---
title: "Create a new URL map for the request account"
method: POST
path: "/url-maps"
tags: ["url-maps"]
---

# Create a new URL map for the request account

`POST /url-maps`

Creates a new URL map and returns the definition

## Request body

- UrlMapConfiguration — The configurable attributes of a URL map
  - `name` string — Name of the URL map
  - `description` string — Description of the URL map
  - `entries` UrlMapEntry[] — Array of URL map entries
    - `from` string, required — The URL that will be mapped from
    - `to` string, required — The URL that will be mapped to

## Response `200`

The URL map was successfully created

- UrlMap — State for a URL map
  - `name` string — Name of the URL map
  - `description` string — Description of the URL map
  - `entries` UrlMapEntry[] — Array of URL map entries
    - `from` string, required — The URL that will be mapped from
    - `to` string, required — The URL that will be mapped to
  - `href` string — A reference to this URL map
  - `created` string, date-time — Time when the map was created
  - `entries_size` number — Total number of entries included in this URL map
  - `updated` string, date-time — Time when the map was last updated

---

[API](https://skmtc.dev/webscale/apis/webscale-apis.md) · [All operations](https://skmtc.dev/webscale/apis/webscale-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webscale/webscale-apis/revisions/c98d872b50cb/schema)