Skip to main content
POST
Create Empty Scenario
Required token scopes: Create scenarios, Manage scenarios on behalf of user (both are required) Optionally, you can include an authorUid body field (a Texter user UID) to attribute the action to a specific user; when omitted, it is attributed automatically.

הרשאות

Authorization
string
header
נדרש

API token generated in Texter: gear icon → Developers → API Tokens. When creating a token, assign it the scopes required by the endpoints you plan to call - each endpoint lists its required scopes.

גוף

application/json
name
string
נדרש

Scenario name

triggerEvent
string
נדרש

The event that triggers this scenario (e.g. domain.message.created). See List Components - Events for available values

description
string
authorUid
string

Optional - Texter user ID (UID) to attribute the scenario to

תגובה

The created scenario (as a draft). Field-by-field reference: The Scenario object

An event subscription (scenario) in Texter

_id
string

Unique identifier of the subscription/scenario

system
string

System scenario identifier. Present only on built-in system scenarios (returned when includeSystem=true)

drafts
object[]

Draft revisions of this scenario being edited. Same shape as a revision, but with status: "draft", no version/revisionComment, and metadata limited to authorUid/created/modified

inactiveRevisions
object[]

Inactive revisions

activeRevision
object

The currently active version of the scenario