How do I add a location?

Requires Pro

Quick answer

Open the Infrastructure module, stay on the Locations tab, and click Add. Only the name is required. Optionally, you can add an address, city, postal code, country, a location group, and a description. The location is the top level of your physical structure.

Prerequisites

The Infrastructure module is available from the Pro plan onward (feature Multi-Tenant). On lower plans, the section is hidden and the API responds with 403.

Open the “Infrastructure” module. Choose Infrastructure in the left-hand navigation. The Locations tab is already active.

Screenshot pending infrastruktur-standort-01 The Infrastructure module with the tabs Locations, Data Centers, Racks, and the active Locations tab

The Infrastructure module with the active 'Locations' tab.
Fill in the location. Click Add and enter at least the name (e.g. “Munich Headquarters”). Optional:
- Location group — choose an existing group
- Address, city, postal code, country
- Description
Screenshot pending infrastruktur-standort-02 The 'Location' form with the fields Name, Location Group, Address, City, Postal Code, Country

The location form. Only the name is required.
Save. The location appears in the list and is available as an assignment for data centers.

Via the REST API: a POST to /api/v1/infrastructure/locations. Only name is required.

curl -X POST https://demo.notory.io/api/v1/infrastructure/locations \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Hauptsitz Muenchen",
    "address": "Leopoldstrasse 1",
    "city": "Muenchen",
    "postal_code": "80802",
    "country": "Deutschland"
  }'

{
  "id": "0190f3b0-1a10-7c20-9d30-4e50f60a7b80",
  "tenant_id": "3d9b0c12-4e5a-4f88-b1c7-2a9e6d4f0011",
  "name": "Hauptsitz Muenchen",
  "group_id": null,
  "address": "Leopoldstrasse 1",
  "city": "Muenchen",
  "postal_code": "80802",
  "country": "Deutschland",
  "description": null,
  "created_at": "2026-07-08T10:00:00Z",
  "updated_at": "2026-07-08T10:00:00Z"
}

You create a location group separately (POST /api/v1/infrastructure/location-groups, name required) and reference its id via group_id.

Possible errors: 401, 403 (no write access or module not included in the plan — Multi-Tenant feature missing), 422 (empty name).

What happens behind the scenes?

License check (gating): Before every action, Notory checks the Multi-Tenant feature. If it’s missing from the plan, the request is rejected with 403 and a pointer to the “Infrastructure & multi-tenant” module.
Tenant assignment: The location belongs to your current tenant and is isolated.
Group reference: If the linked location group is deleted, Notory sets group_id to null (SET NULL); the location remains.
Foundation of the hierarchy: Locations are the top level. Underneath, you organize data centers and racks.