> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Placement

> Add a slot in your app that shows in-app content inline

Creates a [placement](https://docs.sequenzy.com/concepts/in-app-placements.md): a named slot in your app or website, such as a home screen hero, that shows in-app content inside your own layout. Fill it from a sequence step with `type: "in_app"`, `kind: "placement"` and `placement` set to the key. A workspace can have up to 50 placements. Requires the `sequences:write` scope.

## Request

**key** `string` *required*

What your app's code passes to the SDK: 1 to 64 lowercase letters, numbers, dots, dashes or underscores, starting with a letter or number. It never changes after creation.

**name** `string` *required*

Name shown in the dashboard, up to 100 characters.

**description** `string`

Where the slot sits in your app, up to 500 characters.

**width** `integer | null`

Width hint in points (CSS pixels on the web), 1 to 4000. The editor previews content at this size; your app's layout decides the real size.

**height** `integer | null`

Height hint in points, 1 to 4000.

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/in-app/placements" \
  --header "Authorization: Bearer $SEQUENZY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "key": "home_hero",
    "name": "Home hero",
    "description": "Top of the home screen",
    "width": 360,
    "height": 160
  }'
```

```json 201 theme={null}
{
  "success": true,
  "placement": {
    "key": "home_hero",
    "name": "Home hero",
    "description": "Top of the home screen",
    "width": 360,
    "height": 160,
    "createdAt": "2026-11-07T10:00:00.000Z",
    "updatedAt": "2026-11-07T10:00:00.000Z"
  }
}
```

```json 400 theme={null}
{
  "error": "key: Use 1-64 lowercase letters, numbers, dots, dashes or underscores, starting with a letter or number"
}
```

```json 401 theme={null}
{
  "error": "Invalid API key"
}
```

```json 403 theme={null}
{
  "error": "API key is missing required scope: sequences:write"
}
```

```json 409 theme={null}
{
  "error": "A placement with key \"home_hero\" already exists."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.