> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# GetCalendarOptions

# Package: marketingPlan

# Namespace: MarketingSettingsService

# Method link: https://dev.wix.com/docs/api-reference/business-management/marketing/marketing-plan/marketing-settings-v1/get-calendar-options.md

## Permission Scopes:
Manage Marketing Plans: SCOPE.PROMOTE.MANAGE-MARKETING-PLAN

## Introduction

Retrieves the list of calendar options a site can select when configuring marketing settings.

---

## REST API

### Schema

```
 Method: getCalendarOptions
 Description: Retrieves the list of calendar options a site can select when configuring marketing settings.
 URL: https://www.wixapis.com/promote/marketing-plan-service/v1/marketing-settings/calendar-options
 Method: GET
 Return type: GetCalendarOptionsResponse
  - name: options | type: array<CalendarOption> | description: Selectable calendar options, ordered for display.  | validation: minItems 0, maxItems 50
     - name: id | type: string | description: Unique GUID of this calendar option.  | validation: format GUID
     - name: displayName | type: string | description: Display name of the calendar in the account's language.  | validation: maxLength 100
     - name: categories | type: array<CalendarCategory> | description: Classification tags for the calendar (country-specific, religion-specific, or recommended).  | validation: minItems 0, maxItems 10
         - enum:
         -     UNKNOWN: Unspecified category.
         -     COUNTRY: Holidays and events specific to a country.
         -     RELIGION: Observances tied to a religious tradition.
         -     RECOMMENDED: Calendars recommended as a good starting point.
     - name: description | type: string | description: Short description of what events this calendar covers.  | validation: maxLength 100


```

### Examples

### Get calendar options
Retrieve the available calendar options for marketing planning.

```curl
curl -X GET \
'https://www.wixapis.com/promote/marketing-plan-service/v1/marketing-settings/calendar-options' \
-H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.promoteGrowthToolsMarketingPlan.marketingSettings.getCalendarOptions()
 Description: Retrieves the list of calendar options a site can select when configuring marketing settings.
 Return type: PROMISE<GetCalendarOptionsResponse>
  - name: options | type: array<CalendarOption> | description: Selectable calendar options, ordered for display.  | validation: minItems 0, maxItems 50
     - name: _id | type: string | description: Unique GUID of this calendar option.  | validation: format GUID
     - name: displayName | type: string | description: Display name of the calendar in the account's language.  | validation: maxLength 100
     - name: categories | type: array<CalendarCategory> | description: Classification tags for the calendar (country-specific, religion-specific, or recommended).  | validation: minItems 0, maxItems 10
         - enum:
         -     UNKNOWN: Unspecified category.
         -     COUNTRY: Holidays and events specific to a country.
         -     RELIGION: Observances tied to a religious tradition.
         -     RECOMMENDED: Calendars recommended as a good starting point.
     - name: description | type: string | description: Short description of what events this calendar covers.  | validation: maxLength 100


```

### Examples

### Get calendar options
```javascript
import { marketingSettings } from "@wix/promote-growth-tools-marketing-plan";

async function getCalendarOptions() {
  const response = await marketingSettings.getCalendarOptions();
}

/* Promise resolves to:
 * {
 *   "options": [
 *     {
 *       "_id": "9b1d8f2a-7c3e-4a5b-8d6f-1e2c3b4a5d6e",
 *       "displayName": "United States Holidays",
 *       "categories": [
 *         "COUNTRY",
 *         "RECOMMENDED"
 *       ],
 *       "description": "National and federal holidays observed in the United States"
 *     },
 *     {
 *       "_id": "3c7a9e1b-4d2f-48a6-b1c5-6e8d9f0a2b3c",
 *       "displayName": "Christian Holidays",
 *       "categories": [
 *         "RELIGION"
 *       ],
 *       "description": "Major Christian observances such as Christmas and Easter"
 *     }
 *   ]
 * }
 */

```

### getCalendarOptions (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { marketingSettings } from '@wix/promote-growth-tools-marketing-plan';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { marketingSettings },
  // Include the auth strategy and host as relevant
});


async function getCalendarOptions() {
  const response = await myWixClient.marketingSettings.getCalendarOptions();
};
```

---