---
updatedAt: 2025-08-15T15:45:24.000Z
agentTools:
  projectIndex: https://docs.arcadia.com/v1.0-Utility-Cloud/llms.txt
---

# Create Site

This endpoint allows you to create a new site in the Urjanet system. A site object allows you to group credentials, accounts, meters, and statements by a location or another logical grouping for your system.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Utility Cloud",
    "description": "Utility Cloud",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://api.urjanet.com/"
    }
  ],
  "paths": {
    "/utility/sites": {
      "post": {
        "tags": [
          "Sites"
        ],
        "description": "This endpoint allows you to create a new site in the Urjanet system. A site object allows you to group credentials, accounts, meters, and statements by a location or another logical grouping for your system.",
        "operationId": "Create Site",
        "summary": "Create Site",
        "requestBody": {
          "description": "siteRequest",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PublicSiteRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicSiteResource"
                }
              },
              "application/hal+json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicSiteResource"
                }
              }
            }
          }
        },
        "x-codegen-request-body-name": "siteRequest",
        "security": [
          {
            "BearerAuth": []
          },
          {
            "UnifiedAuth": []
          },
          {
            "APIKey": []
          }
        ]
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "x-amazon-apigateway-api-key-source": "AUTHORIZER",
  "x-amazon-apigateway-binary-media-types": [
    "application/pdf",
    "application/zip",
    "application/octet-stream"
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "UnifiedAuth": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-amazon-apigateway-authtype": "custom",
        "x-amazon-apigateway-authorizer": {
          "authorizerUri": "arn:aws:apigateway:us-east-1:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-1:291789168161:function:${stageVariables.authenticatorFunctionName}/invocations",
          "authorizerCredentials": "arn:aws:iam::291789168161:role/${stageVariables.authenticatorRoleName}",
          "authorizerResultTtlInSeconds": 300,
          "type": "token"
        }
      },
      "APIKey": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    },
    "schemas": {
      "PublicUtilityAddressResource": {
        "required": [
          "addressType",
          "city",
          "country",
          "fullAddress",
          "postalCode",
          "recipient",
          "state",
          "streetLine1",
          "streetLine2"
        ],
        "properties": {
          "addressType": {
            "enum": [
              "FULL",
              "PARTIAL"
            ],
            "type": "string"
          },
          "city": {
            "type": "string",
            "description": "This field is searchable.",
            "nullable": true
          },
          "country": {
            "type": "string",
            "description": "This field is searchable.",
            "nullable": true
          },
          "fullAddress": {
            "type": "string",
            "description": "The max length of this field is 500 characters. This field is searchable.",
            "nullable": true
          },
          "postalCode": {
            "type": "string",
            "description": "This field is searchable.",
            "nullable": true
          },
          "recipient": {
            "type": "string",
            "description": "This field is searchable.",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "This field is searchable.",
            "nullable": true
          },
          "streetLine1": {
            "type": "string",
            "description": "This field is searchable.",
            "nullable": true
          },
          "streetLine2": {
            "type": "string",
            "description": "This field is searchable.",
            "nullable": true
          }
        },
        "title": "PublicUtilityAddressResource",
        "type": "object"
      },
      "PublicSiteRequest": {
        "required": [
          "siteName"
        ],
        "properties": {
          "city": {
            "type": "string",
            "description": "Optional field to add site's city"
          },
          "country": {
            "type": "string",
            "description": "Optional field to add site's country"
          },
          "facilityType": {
            "type": "string",
            "description": "Optional field to add site's facility type"
          },
          "postalCode": {
            "type": "string",
            "description": "Optional field to add site's postal code"
          },
          "region": {
            "type": "string",
            "description": "Optional field to add site's region"
          },
          "siteCode": {
            "type": "string",
            "description": "Optional field to add site's code"
          },
          "siteName": {
            "type": "string",
            "description": "Optional field to add site's name"
          },
          "siteNumber": {
            "type": "string",
            "description": "Optional field to add site's number"
          },
          "subRegion": {
            "type": "string",
            "description": "Optional field to add site's sub region"
          },
          "state": {
            "type": "string",
            "description": "Optional field to add site's state"
          },
          "streetLine1": {
            "type": "string",
            "description": "Optional field to add site's street information"
          },
          "streetLine2": {
            "type": "string",
            "description": "Optional field to add site's street information"
          }
        },
        "title": "PublicSiteRequest",
        "type": "object"
      },
      "PublicSiteResource": {
        "required": [
          "createdBy",
          "createdDate",
          "entityId",
          "facilityType",
          "id",
          "lastModifiedBy",
          "lastModifiedDate",
          "meterIds",
          "region",
          "serviceAddress",
          "siteCode",
          "siteName",
          "siteNumber",
          "subRegion"
        ],
        "properties": {
          "createdBy": {
            "type": "string",
            "nullable": true
          },
          "createdDate": {
            "format": "date-time",
            "type": "string"
          },
          "entityId": {
            "type": "string",
            "description": "Site ID (UUID)"
          },
          "facilityType": {
            "type": "string",
            "nullable": true
          },
          "lastModifiedBy": {
            "type": "string",
            "nullable": true
          },
          "lastModifiedDate": {
            "format": "date-time",
            "type": "string"
          },
          "region": {
            "type": "string",
            "nullable": true
          },
          "serviceAddress": {
            "$ref": "#/components/schemas/PublicUtilityAddressResource",
            "description": "This field is searchable.",
            "nullable": true
          },
          "siteCode": {
            "type": "string",
            "nullable": true,
            "description": "This field is searchable."
          },
          "siteName": {
            "type": "string",
            "description": "This field is searchable."
          },
          "siteNumber": {
            "type": "string",
            "nullable": true,
            "description": "This field is searchable."
          },
          "subRegion": {
            "nullable": true,
            "type": "string"
          },
          "_links": {
            "properties": {
              "self": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                }
              },
              "accounts": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                }
              },
              "credentials": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                }
              },
              "events": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                }
              },
              "meters": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                }
              },
              "statements": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "title": "PublicSiteResource",
        "type": "object"
      }
    }
  },
  "tags": [
    {
      "name": "Sites"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  }
}
```