---
title: "Create a grid planner item"
method: POST
path: "/v1/workspaces/{workspaceId}/grid-planner/items"
tags: ["Grid Planner"]
---

# Create a grid planner item

`POST /v1/workspaces/{workspaceId}/grid-planner/items`

## 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}/grid-planner/items`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- union
  - object
    - `integrationId` string, uuid, required
    - `coverMediaId` string, uuid, nullable
    - `note` string, nullable
    - `position` integer, nullable
    - `settings` GridPlannerItemSettingsDto
      - `aspectRatio` number, nullable
      - `placeholder` GridPlannerPlaceholderSettingsDto
        - `title` string, nullable
        - `color` string, required
    - `kind` 'visual_only', required
    - `mediaIds` string[], required
    - `linkedContentId` unknown
  - object
    - `integrationId` string, uuid, required
    - `coverMediaId` string, uuid, nullable
    - `note` string, nullable
    - `position` integer, nullable
    - `settings` GridPlannerItemSettingsDto
      - `aspectRatio` number, nullable
      - `placeholder` GridPlannerPlaceholderSettingsDto
        - `title` string, nullable
        - `color` string, required
    - `kind` 'linked_post', required
    - `mediaIds` unknown
    - `linkedContentId` string, uuid, required
  - object
    - `integrationId` string, uuid, required
    - `coverMediaId` string, uuid, nullable
    - `note` string, nullable
    - `position` integer, nullable
    - `settings` GridPlannerItemSettingsDto, required
      - `aspectRatio` number, nullable
      - `placeholder` GridPlannerPlaceholderSettingsDto
        - `title` string, nullable
        - `color` string, required
    - `kind` 'placeholder', required
    - `mediaIds` unknown
    - `linkedContentId` unknown

## Response `201`

Grid planner item created

- object
  - `data` PublicGridPlannerItemDto, required
    - `id` string, uuid, required
    - `integrationId` string, uuid, required
    - `kind` 'visual_only' | 'linked_post' | 'placeholder', required
    - `position` number, required
    - `linkedPostId` string, uuid, nullable, required: Linked content edition ID (content.id), kept as linkedPostId for API compatibility.
    - `note` string, nullable, required
    - `settings` object, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `coverMedia` PublicGridPlannerMediaDto, required
      - `id` string, uuid, required
      - `url` string, required
      - `thumbnailUrl` string, nullable, required
      - `type` string, required
    - `media` PublicGridPlannerMediaDto[], required
      - `id` string, uuid, required
      - `url` string, required
      - `thumbnailUrl` string, nullable, required
      - `type` string, required
    - `post` PublicGridPlannerLinkedPostDto, required
      - `id` string, uuid, required: Linked content edition ID (content.id). Grid planner linked items intentionally remain edition-level.
      - `status` string, required
      - `scheduledAt` string, nullable, required
      - `sentAt` string, nullable, required
      - `captions` CaptionsDto, required
        - `canonical` string, nullable
        - `overrides` CaptionOverridesDto
          - `x` string, nullable
          - `linkedin` string, nullable
          - `linkedin-page` string, nullable
          - `youtube` string, nullable
          - `instagram` string, nullable
          - `facebook` string, nullable
          - `threads` string, nullable
          - `tiktok` string, nullable
          - `pinterest` string, nullable
          - `google-business-profile` string, nullable
      - `resolvedCaption` string, required
      - `postType` string, required
      - `firstComment` string, nullable, required
      - `shareToFeed` boolean, required
      - `contentMedia` PublicContentMediaAttachmentDto[], required
        - `mediaId` string, uuid, required
        - `order` number, required
        - `type` string, nullable, required
        - `url` string, nullable, required
        - `thumbnailUrl` string, nullable, required
        - `filename` string, nullable, required
        - `crops` object, required
        - `userTags` object[], required
        - `productTags` object[], required
        - `cover` object, nullable, required
      - `media` PublicGridPlannerMediaDto[], required
        - `id` string, uuid, required
        - `url` string, required
        - `thumbnailUrl` string, nullable, required
        - `type` string, required
      - `campaignId` string, uuid, nullable, required
      - `campaignPhaseId` string, uuid, nullable, required
      - `priority` 'urgent' | 'high' | 'medium' | 'low'
  - `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)