---
title: "Create action"
method: POST
path: "/v1/action"
tags: ["action"]
---

# Create action

`POST /v1/action`

## Request

- Base URL: `https://rule-engine-api.frisbii.com`
- URL: `https://rule-engine-api.frisbii.com/v1/action`
- Auth: HTTP basic

## Request body

- CreateActionDto: Base Dto for all create action types
  - `action` string, required: Action type
  - `schedule` ScheduleDto, required: Scheduling settings for the action
    - `execution_date` string, date-time: Execution time of the action. You must provide either an event type or an execution date.
    - `event_type` string: Event type which triggers the action. You must provide either an event type or an execution date.

## Response `200`

Successful operation

- ResponseActionDto: List of actions for current page
  - `id` string: Action id
  - `state` 'new' | 'success' | 'failure' | 'retrying' | 'nothing_to_do': State of the action
  - `created` string, date-time: Action created timestamp
  - `details` ResponseActionDetailsDto: Action details
    - `type` string
  - `action` string, required: Action type
  - `schedule` ScheduleDto, required: Scheduling settings for the action
    - `execution_date` string, date-time: Execution time of the action. You must provide either an event type or an execution date.
    - `event_type` string: Event type which triggers the action. You must provide either an event type or an execution date.
  - `entity_id` string: The ID (handle) of the product on which the action is performed.
  - `entity_type` string: Type of the entity on which the action is performed.
  - `additional_actions` ResponseActionDto[]: List of additional actions that will be executed

## Other responses

- `400`: Invalid request, see error codes at https://api.reepay.com/v1/error_codes
- `401`: None or invalid credentials provided in access to secured resource
- `403`: Not authorized to perform resource operation
- `404`: Resource or referenced resource not found, see error codes at https://api.reepay.com/v1/error_codes
- `429`: Request limiting exceeded, request rate or concurrent requests, see error code 122 and 123
- `500`: Internal service error, error is reported automatically to Frisbii

---

[API](https://skmtc.dev/frisbii/apis/frisbii-rule-engine-api.md) - [All operations](https://skmtc.dev/frisbii/apis/frisbii-rule-engine-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frisbii/apis/frisbii-rule-engine-api/revisions/62a992b1a09d?raw)