---
title: "Create a new Custom Placeholder"
method: POST
path: "/v4/messages/placeholders"
tags: ["Messaging"]
---

# Create a new Custom Placeholder

`POST /v4/messages/placeholders`

## Request body

- CreateCustomPlaceholderRequest
  - `placeholderLabel` string, nullable
  - `placeholderType` string, nullable
  - `mappings` PlaceholderMapping[], nullable
    - `id` string, nullable
    - `formId` string, uuid, nullable
    - `formFieldId` string, nullable
    - `isDeleted` boolean

## Response `201`

Created

- PlaceholderResponse
  - `id` string, nullable
  - `label` string, nullable
  - `isDisabled` boolean
  - `organizationId` string, nullable
  - `type` string, nullable
  - `lastUpdatedAt` string, date-time, nullable
  - `integrationSyncs` PlaceholderIntegrationSyncResponse[], nullable
    - `integrationType` string, nullable
    - `lastSyncDate` string, date-time, nullable
  - `mappings` PlaceholderMappingsResponse[], nullable
    - `formId` string, uuid, nullable
    - `formFieldId` string, nullable

---

[API](https://skmtc.net/submittable/apis/submittable-api-documentation.md) · [All operations](https://skmtc.net/submittable/apis/submittable-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/submittable/submittable-api-documentation/revisions/254ce50c8212/schema)