---
title: "PUT /v1/templates/{template-name}/inapp"
method: PUT
path: "/v1/templates/{template-name}/inapp"
---

# PUT /v1/templates/{template-name}/inapp

`PUT /v1/templates/{template-name}/inapp`

Updates an existing message template for messages sent through the in-app message channel.

## Path parameters

- `template-name` string, required

## Query parameters

- `create-new-version` boolean
- `version` string

## Request body

- object
  - `InAppTemplateRequest` object, required — InApp Template Request.
    - `Content` InAppMessageContent[] — The content of the message, can include up to 5 modals. Each modal must contain a message, a header, and background color. ImageUrl and buttons are optional.
      - `BackgroundColor` string — The background color for the message.
      - `BodyConfig` object — The configuration for the message body.
        - `Alignment` 'LEFT' | 'CENTER' | 'RIGHT', required — The alignment of the text. Valid values: LEFT, CENTER, RIGHT.
        - `Body` string, required — Message Body.
        - `TextColor` string, required — The text color.
      - `HeaderConfig` object — The configuration for the message header.
        - `Alignment` 'LEFT' | 'CENTER' | 'RIGHT', required — The alignment of the text. Valid values: LEFT, CENTER, RIGHT.
        - `Header` string, required — Message Header.
        - `TextColor` string, required — The text color.
      - `ImageUrl` string — The image url for the background of message.
      - `PrimaryBtn` object — The first button inside the message.
        - `Android` object — Default button content.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
        - `DefaultConfig` object — Default button content.
          - `BackgroundColor` string — The background color of the button.
          - `BorderRadius` integer — The border radius of the button.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
          - `Text` string, required — Button text.
          - `TextColor` string — The text color of the button.
        - `IOS` object — Default button content.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
        - `Web` object — Default button content.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
      - `SecondaryBtn` object — The second button inside message.
        - `Android` object — Default button content.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
        - `DefaultConfig` object — Default button content.
          - `BackgroundColor` string — The background color of the button.
          - `BorderRadius` integer — The border radius of the button.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
          - `Text` string, required — Button text.
          - `TextColor` string — The text color of the button.
        - `IOS` object — Default button content.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
        - `Web` object — Default button content.
          - `ButtonAction` 'LINK' | 'DEEP_LINK' | 'CLOSE', required — Action triggered by the button.
          - `Link` string — Button destination.
    - `CustomConfig` object — Custom config to be sent to client.
    - `Layout` 'BOTTOM_BANNER' | 'TOP_BANNER' | 'OVERLAYS' | 'MOBILE_FEED' | 'MIDDLE_BANNER' | 'CAROUSEL' — The layout of the message.
    - `tags` object — A string-to-string map of key-value pairs that defines the tags to associate with the message template. Each tag consists of a required tag key and an associated tag value.
    - `TemplateDescription` string — The description of the template.

## Response `202`

Success

- UpdateInAppTemplateResponse
  - `MessageBody` MessageBody, required — Provides information about an API request or response.
    - `Message` string — The message that's returned from the API.
    - `RequestID` string — The unique identifier for the request or response.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException
- `482` — PayloadTooLargeException
- `483` — ForbiddenException
- `484` — NotFoundException
- `485` — MethodNotAllowedException
- `486` — TooManyRequestsException

---

[API](https://skmtc.net/aws/apis/pinpoint.md) · [All operations](https://skmtc.net/aws/apis/pinpoint/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/pinpoint/versions/c0cf580f498b/schema)