Skip to main content
POST
Create action
Creates an Action: an outbound API call invoked by a Rulebook Tool node. Omit alwaysGet or send false; sending true creates an Attribute instead.
This route creates the record only. Add the input and output schema with Update action, then add its HTTP calls with Create data step.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
string
required
application/json

Body parameters

string
required
Display name.
string
Optional human-readable description.
boolean
default:"false"
Leave as false for an action. true creates an attribute that runs automatically each conversation.
string
Optional source. Current values include ui, api, widget, and integration providers such as zendesk and intercom.

Response

Returns the created Action / Attribute. inputSchema and outputSchema start empty.

Errors

The body is malformed or source uses an unsupported value.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.
Fini failed while creating the record in storage.