---
title: "Update a custom placeholder and any of its mappings"
method: PUT
path: "/v4/messages/placeholders/{placeholderId}"
tags: ["Messaging"]
---

# Update a custom placeholder and any of its mappings

`PUT /v4/messages/placeholders/{placeholderId}`

## Path parameters

- `placeholderId` string, required

## Request body

- UpdateCustomPlaceholderRequest
  - `isDisabled` boolean
  - `mappings` PlaceholderMapping[], nullable
    - `id` string, nullable
    - `formId` string, uuid, nullable
    - `formFieldId` string, nullable
    - `isDeleted` boolean

## Response `200`

Success

- 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

## Other responses

- `400` — Invalid request
- `403` — Insufficient permissions

---

[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/versions/254ce50c8212/schema)