---
title: "Create a public Calendar snapshot"
method: POST
path: "/v1/workspaces/{workspaceId}/calendar/snapshots"
tags: ["Calendar"]
---

# Create a public Calendar snapshot

`POST /v1/workspaces/{workspaceId}/calendar/snapshots`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/calendar/snapshots`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- CreateCalendarShareLinkDto
  - `settings` CalendarShareSettingsDto, required
    - `version` 1, required
    - `title` string, required
    - `dateRange` CalendarShareDateRangeDto, required
      - `start` string, required
      - `end` string, required
    - `filters` CalendarShareFiltersDto, required
      - `integrationIds` string[], nullable
      - `platforms` string[], nullable
      - `statuses` string[], required
      - `campaignIds` string[], nullable
      - `labelIds` string[], nullable
      - `pillarIds` string[], nullable
      - `formatIds` string[], nullable
      - `includePostedHistory` boolean, required
      - `includeScheduledFuture` boolean, required
      - `includeReviewItems` boolean, required
      - `includeDrafts` boolean, required
      - `includeCalendarNotes` boolean, required
    - `include` CalendarShareIncludeDto, required
      - `captions` boolean, required
      - `media` boolean, required
      - `postTitles` boolean, required
      - `firstComments` boolean, required
      - `threadPosts` boolean, required
      - `accountNames` boolean, required
      - `accountAvatars` boolean, required
      - `highLevelApprovalState` boolean, required
      - `exactPublishTimes` boolean, required
      - `labels` boolean, required
      - `pillars` boolean, required
      - `formats` boolean, required
  - `expiresAt` string, required

## Response `201`

Calendar result

- object
  - `data` PublicCalendarCreatedShareLinkDto, required
    - `id` string, uuid, required
    - `title` string, required
    - `status` 'active' | 'expired' | 'revoked', required
    - `currentVersion` number, required
    - `settings` object, required
      - `version` 1, required
      - `title` string, required
      - `dateRange` object, required
        - `start` string, date-time, required
        - `end` string, date-time, required
      - `filters` object, required
        - `integrationIds` string[]
        - `platforms` string[]
        - `statuses` string[], required
        - `campaignIds` string[]
        - `labelIds` string[]
        - `pillarIds` string[]
        - `formatIds` string[]
        - `includePostedHistory` boolean, required
        - `includeScheduledFuture` boolean, required
        - `includeReviewItems` boolean, required
        - `includeDrafts` boolean, required
        - `includeCalendarNotes` boolean, required
      - `include` object, required
        - `captions` boolean, required
        - `media` boolean, required
        - `postTitles` boolean, required
        - `firstComments` boolean, required
        - `threadPosts` boolean, required
        - `accountNames` boolean, required
        - `accountAvatars` boolean, required
        - `highLevelApprovalState` boolean, required
        - `exactPublishTimes` boolean, required
        - `labels` boolean, required
        - `pillars` boolean, required
        - `formats` boolean, required
    - `dateRange` object, nullable, required
      - `start` string, date-time, required
      - `end` string, date-time, required
    - `expiresAt` string, date-time, required
    - `revokedAt` string, date-time, nullable, required
    - `viewCount` number, required
    - `lastViewedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `latestGeneratedAt` string, date-time, nullable, required
    - `token` string, required
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)