---
title: "Create a date range"
method: POST
path: "/{globalCompanyId}/dateranges"
tags: ["Date Ranges"]
---

# Create a date range

`POST /{globalCompanyId}/dateranges`

## Path parameters

- `globalCompanyId` string, required

## Query parameters

- `expansion` string[]
- `newDefinition` boolean
- `locale` string

## Headers

- `Authorization` string, required
- `x-api-key` string, required

## Request body

- ExpandedDateRange
  - `id` string
  - `name` string
  - `description` string
  - `modified` string, date-time
  - `companyId` integer
  - `owner` object
  - `definition` object
  - `template` boolean
  - `createDate` string, date-time
  - `disabledDate` string, date-time
  - `alternateVariableNames` AlternateVariableNames
    - `name` string
    - `baseName` string
    - `curatedName` string
  - `curatedItem` boolean
  - `imsOrgId` string
  - `systemUserOwned` boolean
  - `tags` object[]
  - `shares` object[]
  - `approved` boolean
  - `favorite` boolean
  - `usageSummary` object

## Response `200`

successful operation

- ExpandedDateRange
  - `id` string
  - `name` string
  - `description` string
  - `modified` string, date-time
  - `companyId` integer
  - `owner` object
  - `definition` object
  - `template` boolean
  - `createDate` string, date-time
  - `disabledDate` string, date-time
  - `alternateVariableNames` AlternateVariableNames
    - `name` string
    - `baseName` string
    - `curatedName` string
  - `curatedItem` boolean
  - `imsOrgId` string
  - `systemUserOwned` boolean
  - `tags` object[]
  - `shares` object[]
  - `approved` boolean
  - `favorite` boolean
  - `usageSummary` object

## Changes

- **2025-08-07** `f13c80692287` — 1 warning
  - deleted the `header` request parameter `x-gw-ims-org-id`
- **2025-08-06** `f49e893a6c2b` — 1 breaking
  - added the new required `header` request parameter `x-gw-ims-org-id`
- **2022-05-10** `dcd4514630c4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/adobe/apis/adobe-analytics-apis/changes/:globalCompanyId/dateranges/post.md)

---

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