Create a new step in an automation

POST

/automations/{uuid}/steps

Last modified:2026-02-17 18:57:15

Creates a step. If step_number is omitted, appends to end. If provided, existing steps are shifted to make room.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Step created

Body

🟠404Record Not Found

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://connect.dispatchable.com/automations/api/v1/automations//steps' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "step_app": "email",
    "step_name": "Send dispatch notification",
    "step_type": "string",
    "step_description": "string",
    "step_number": 1
}'

Response Example

201 - Example 1

{
    "data": {
        "id": 0,
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "company_uuid": "aba69bec-94b3-48e8-9737-4f951465d0f8",
        "automation_id": 0,
        "step_number": 0,
        "step_app": "email",
        "step_name": "Send dispatch notification",
        "step_type": "string",
        "step_description": "string",
        "step_trigger": "string",
        "relation_operator": "string",
        "step_trigger_value": "string",
        "step_action": "string",
        "step_action_value": "string",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z"
    },
    "message": "string",
    "success": true
}

Modified at 2026-02-17 18:57:15

List steps for an automation

Reorder automation steps