---
title: Create an origin cloud region mapping
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Cache](https://developers.cloudflare.com/api/resources/cache)
[Origin Cloud Regions](https://developers.cloudflare.com/api/resources/cache/subresources/origin_cloud_regions)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Create an origin cloud region mapping
Deprecated: Use update instead (PUT /origin/cloud\_regions/{origin\_ip}). Old path /cache/origin\_cloud\_regions will be removed in the future.
POST/zones/{zone\_id}/cache/origin\_cloud\_regions
Adds a single IP-to-cloud-region mapping for the zone. The IP must be a valid IPv4 or IPv6 address and is normalized to canonical form before storage (RFC 5952 for IPv6). Returns 400 (code 1145) if a mapping for that IP already exists — use PATCH to update an existing entry. The vendor and region are validated against the list from `GET /zones/{zone_id}/cache/origin_cloud_regions/supported_regions`.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### P ath ParametersExpand Collapse
zone\_id: string
Identifier.
maxLength32
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>)
##### Body ParametersJSONExpand Collapse
ip: string
Origin IP address (IPv4 or IPv6). Normalized to canonical form before storage (RFC 5952 for IPv6).
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(params)%200%20%3E%20(param)%20ip%20%3E%20(schema)>)
region: string
Cloud vendor region identifier. Must be a valid region for the specified vendor as returned by the supported\_regions endpoint.
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(params)%200%20%3E%20(param)%20region%20%3E%20(schema)>)
vendor: "aws"or "azure"or "gcp"or "oci"
Cloud vendor hosting the origin. Must be one of the supported vendors.
One of the following:
"aws"
Link to this property
"azure"
Link to this property
"gcp"
Link to this property
"oci"
Link to this property
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(params)%200%20%3E%20(param)%20vendor%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of ResponseInfo { code, message, documentation\_url, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of ResponseInfo { code, message, documentation\_url, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
success: true
Whether the API call was successful.
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result: optional object {id, editable, value, modified\_on }
Response result for a single origin cloud region mapping.
id: "origin\_public\_cloud\_region"
Link to this property
editable: boolean
Whether the setting can be modified by the current user.
Link to this property
value: object {"origin-ip", region, vendor, modified\_on }
A single origin IP-to-cloud-region mapping.
"origin-ip": string
The origin IP address (IPv4 or IPv6, canonicalized).
Link to this property
region: string
Cloud vendor region identifier.
Link to this property
vendor: "aws"or "azure"or "gcp"or "oci"
Cloud vendor hosting the origin.
One of the following:
"aws"
Link to this property
"azure"
Link to this property
"gcp"
Link to this property
"oci"
Link to this property
Link to this property
modified\_on: optional string
Time this mapping was last modified.
formatdate-time
Link to this property
Link to this property
modified\_on: optional string
Time the mapping was last modified.
formatdate-time
Link to this property
[Link to this property](<#(resource)%20cache.origin_cloud_regions%20%3E%20(method)%20create_v1%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
### Create an origin cloud region mapping
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/zones/$ZONE_ID/cache/origin_cloud_regions \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{
"ip": "192.0.2.1",
"region": "us-east-1",
"vendor": "aws"
}'
```
200 example
4XX example
4XX example
4XX example
```
{
"errors": [],
"messages": [],
"result": {
"editable": true,
"id": "origin_public_cloud_region",
"modified_on": "2026-03-01T12:00:00Z",
"value": {
"modified_on": "2026-03-01T12:00:00Z",
"origin-ip": "192.0.2.1",
"region": "us-east-1",
"vendor": "aws"
}
},
"success": true
}
```
```
{
"errors": [
{
"code": 1145,
"message": "Unable to create new origin_public_cloud_region setting. The zone setting already exists."
}
],
"messages": [],
"result": null,
"success": false
}
```
```
{
"errors": [
{
"code": 1146,
"message": "Invalid or missing origin IP address."
}
],
"messages": [],
"result": null,
"success": false
}
```
```
{
"errors": [
{
"code": 1157,
"message": "The vendor provided doesn't exist or the region provided does not exist for the specified cloud vendor"
}
],
"messages": [],
"result": null,
"success": false
}
```
##### Returns Examples
200 example
4XX example
4XX example
4XX example
```
{
"errors": [],
"messages": [],
"result": {
"editable": true,
"id": "origin_public_cloud_region",
"modified_on": "2026-03-01T12:00:00Z",
"value": {
"modified_on": "2026-03-01T12:00:00Z",
"origin-ip": "192.0.2.1",
"region": "us-east-1",
"vendor": "aws"
}
},
"success": true
}
```
```
{
"errors": [
{
"code": 1145,
"message": "Unable to create new origin_public_cloud_region setting. The zone setting already exists."
}
],
"messages": [],
"result": null,
"success": false
}
```
```
{
"errors": [
{
"code": 1146,
"message": "Invalid or missing origin IP address."
}
],
"messages": [],
"result": null,
"success": false
}
```
```
{
"errors": [
{
"code": 1157,
"message": "The vendor provided doesn't exist or the region provided does not exist for the specified cloud vendor"
}
],
"messages": [],
"result": null,
"success": false
}
```