Skip to main content
POST
Create Placement
Creates a placement: 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

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.
string
required
Name shown in the dashboard, up to 100 characters.
string
Where the slot sits in your app, up to 500 characters.
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.
integer | null
Height hint in points, 1 to 4000.