---
title: "Create Installed App Events"
method: POST
path: "/installedapps/{installedAppId}/events"
tags: ["Installedapps"]
---

# Create Installed App Events

`POST /installedapps/{installedAppId}/events`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/installedapps/{installedAppId}/events`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/installedapps/:installedAppId/events/post.ts> (a function with typed inputs; its response is checked against the schema)

Create events for an installed app.  This allows Apps to create events to trigger custom behavior in
installed apps. Requires a SmartApp token.

## Request body

- CreateInstalledAppEventsRequest
  - `smartAppEvents` SmartAppEventRequest[]: An array of smartapp events used to trigger client behavior in loaded web plugin detail pages. Events will be delivered to JavaScript event handler of all active client processes related to parameterized installed app.
    - `name` string, ^[a-zA-Z_]{1,36}$: An arbitrary name for the custom SmartApp event. Typically useful as a hook for in-app routing.
    - `attributes` object: An arbitrary set of key / value pairs useful for passing any custom metadata. * Supports a maximum of 10 entries. * Maximum key length: 36 Unicode characters in UTF-8 * Maximum value length: 256 Unicode characters in UTF-8 * Allowed characters for *keys* are letters, plus the following special characters: `:`, `_` * Allowed characters for *values* are letters, whitespace, and numbers, plus the following special characters: `+`, `-`, `=`, `.`, `_`, `:`, `/` * If you need characters outside this allowed set, you can apply standard base-64 encoding.
  - `smartAppDashboardCardEvents` SmartAppDashboardCardEventRequest[]: An array of smartapp dashboard card events used to trigger client behavior for dashboard cards. Dashboard card events are directives to a SmartThings client to take actions in relation to lifecycle changes to a specific dashboard card. These events are not delivered to the web plugin event handler.
    - `cardId` string, ^[a-z0-9.-_]{1,36}$: A developer defined dashboard card ID.
    - `lifecycle` 'UPDATE' | 'DELETE'

## Response `200`

Created events.

- CreateInstalledAppEventsResponse

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `429`: Too many requests
- `default`: Unexpected error

---

[API](https://skmtc.dev/smartthings/apis/smartthings-api.md) - [All operations](https://skmtc.dev/smartthings/apis/smartthings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartthings/apis/smartthings-api/revisions/2788a4236800?raw)