> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Luma: Post V2 Organizations Calendars Create

> Create a new calendar within the organization. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Create a new calendar within the organization.

<Info>
  Tool ID: `luma_post_v2_organizations_calendars_create`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'luma_post_v2_organizations_calendars_create',
  {
    "name": "Example"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute luma_post_v2_organizations_calendars_create --input '{
  "name": "Example"
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "id": "id_123",
    "name": "Example",
    "slug": "example",
    "avatar_url": "https://example.com",
    "url": "https://example.com",
    "description": "Example description",
    "social_image_url": "https://example.com",
    "cover_image_url": "https://example.com",
    "is_personal": true,
    "location": {
      "city": "San Francisco",
      "region": "example",
      "country": "US",
      "country_code": "example",
      "timezone": "America/New_York"
    },
    "coordinate": {
      "longitude": 123,
      "latitude": 123
    },
    "instagram_handle": "example",
    "twitter_handle": "example",
    "youtube_handle": "example",
    "website": "https://example.com"
  }
}
```

Use `deepline tools get luma_post_v2_organizations_calendars_create --json` for the latest machine-readable contract.

## Input reference

Create a new calendar within the organization. The calendar will be managed by the API key owner.

| Name                  | Type     | Required | Default | Details                                                                                                                               |
| --------------------- | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.name`        | `string` | Yes      | —       | Name of the calendar.                                                                                                                 |
| `payload.slug`        | `string` | No       | —       | URL slug for the calendar page (e.g. 'my-community' → lu.ma/my-community).                                                            |
| `payload.description` | `string` | No       | —       | Short description of the calendar.                                                                                                    |
| `payload.avatar_url`  | `string` | No       | —       | Specify an image that has been uploaded to the Luma CDN. If not provided, a random default avatar will be used. Format: `uri`.        |
| `payload.tint_color`  | `string` | No       | —       | Tint color for the calendar in hex format (e.g. '#E3CBEF'). If not provided, a random color matching the default avatar will be used. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Create a new calendar within the organization. The calendar will be managed by the API key owner.",
    "properties": {
      "name": {
        "type": "string",
        "description": "Name of the calendar."
      },
      "slug": {
        "type": "string",
        "description": "URL slug for the calendar page (e.g. 'my-community' → lu.ma/my-community)."
      },
      "description": {
        "type": "string",
        "description": "Short description of the calendar."
      },
      "avatar_url": {
        "type": "string",
        "description": "Specify an image that has been uploaded to the Luma CDN. If not provided, a random default avatar will be used.",
        "format": "uri"
      },
      "tint_color": {
        "type": "string",
        "description": "Tint color for the calendar in hex format (e.g. '#E3CBEF'). If not provided, a random color matching the default avatar will be used."
      }
    },
    "required": [
      "name"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name                                | Type             | Required | Default | Details                                                                                                                        |
| ----------------------------------- | ---------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `result.data`                       | `object`         | Yes      | —       | Provider response payload.                                                                                                     |
| `result.data.id`                    | `string`         | Yes      | —       | —                                                                                                                              |
| `result.data.name`                  | `string`         | Yes      | —       | —                                                                                                                              |
| `result.data.slug`                  | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.avatar_url`            | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.url`                   | `string`         | Yes      | —       | —                                                                                                                              |
| `result.data.description`           | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.social_image_url`      | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.cover_image_url`       | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.is_personal`           | `boolean`        | Yes      | —       | —                                                                                                                              |
| `result.data.location`              | `object \| null` | Yes      | —       | City the calendar is based in (e.g. for city calendars). Null when the calendar isn't tied to a place.                         |
| `result.data.location.city`         | `string`         | Yes      | —       | City name, e.g. 'New York'.                                                                                                    |
| `result.data.location.region`       | `string \| null` | Yes      | —       | State or province, e.g. 'New York' or 'California'.                                                                            |
| `result.data.location.country`      | `string \| null` | Yes      | —       | Country name, e.g. 'United States'. Null for cities in disputed territories where Google omits the country.                    |
| `result.data.location.country_code` | `string \| null` | Yes      | —       | ISO 3166-1 alpha-2 country code, e.g. 'US'.                                                                                    |
| `result.data.location.timezone`     | `string`         | Yes      | —       | IANA timezone of the city, e.g. 'America/New\_York'.                                                                           |
| `result.data.coordinate`            | `object \| null` | Yes      | —       | Latitude and longitude of the calendar's primary location (e.g. city calendars). Null when the calendar isn't tied to a place. |
| `result.data.coordinate.longitude`  | `number`         | Yes      | —       | —                                                                                                                              |
| `result.data.coordinate.latitude`   | `number`         | Yes      | —       | —                                                                                                                              |
| `result.data.instagram_handle`      | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.twitter_handle`        | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.youtube_handle`        | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.data.website`               | `string \| null` | Yes      | —       | —                                                                                                                              |
| `result.meta`                       | `object`         | No       | —       | Additional response metadata (status, paging).                                                                                 |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "avatar_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "social_image_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "cover_image_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "is_personal": {
            "type": "boolean"
          },
          "location": {
            "type": [
              "object",
              "null"
            ],
            "description": "City the calendar is based in (e.g. for city calendars). Null when the calendar isn't tied to a place.",
            "properties": {
              "city": {
                "type": "string",
                "description": "City name, e.g. 'New York'."
              },
              "region": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "State or province, e.g. 'New York' or 'California'."
              },
              "country": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Country name, e.g. 'United States'. Null for cities in disputed territories where Google omits the country."
              },
              "country_code": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "ISO 3166-1 alpha-2 country code, e.g. 'US'."
              },
              "timezone": {
                "type": "string",
                "description": "IANA timezone of the city, e.g. 'America/New_York'."
              }
            },
            "required": [
              "city",
              "region",
              "country",
              "country_code",
              "timezone"
            ],
            "additionalProperties": false
          },
          "coordinate": {
            "type": [
              "object",
              "null"
            ],
            "description": "Latitude and longitude of the calendar's primary location (e.g. city calendars). Null when the calendar isn't tied to a place.",
            "properties": {
              "longitude": {
                "type": "number"
              },
              "latitude": {
                "type": "number"
              }
            },
            "required": [
              "longitude",
              "latitude"
            ],
            "additionalProperties": false
          },
          "instagram_handle": {
            "type": [
              "string",
              "null"
            ]
          },
          "twitter_handle": {
            "type": [
              "string",
              "null"
            ]
          },
          "youtube_handle": {
            "type": [
              "string",
              "null"
            ]
          },
          "website": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "avatar_url",
          "url",
          "description",
          "social_image_url",
          "cover_image_url",
          "is_personal",
          "location",
          "coordinate",
          "instagram_handle",
          "twitter_handle",
          "youtube_handle",
          "website"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Luma provider guide](/docs/providers/luma/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)