Workflows

Workflows allow you to automate actions based on segments. You can create workflows that trigger daily recurrence reviews or assign users based on segment visibility. On this page, we'll cover how to create and delete workflows via the API.

The workflow model

The workflow model contains information about your automated workflows, including their name, status, and associated nodes (trigger, action, notification).

Properties

Name
id
Type
integer
Description
Unique identifier for the workflow.
Name
uuid
Type
string
Description
UUID of the workflow.
Name
name
Type
string
Description
The name of the workflow, auto-generated from the segment name and workflow type.
Name
status
Type
string
Description
The status of the workflow. Can be draft, active, paused, or ended.
Name
team_id
Type
integer
Description
The unique identifier of the team that owns the workflow.
Name
is_automatic
Type
boolean
Description
Whether the workflow was created automatically.
Name
nodes
Type
array
Description
The list of nodes (trigger, action, notification) attached to the workflow.
Name
created_at
Type
timestamp
Description
Timestamp of when the workflow was created.
Name
updated_at
Type
timestamp
Description
Timestamp of when the workflow was last updated.

POST/v3/workflows

Create a workflow

This endpoint allows you to create a new workflow based on an existing segment. The workflow will be created with a trigger, an action, and a notification node configured automatically based on the segment and workflow type.

Required attributes

Name
segment_id
Type
integer
Description
The unique identifier of the segment to base the workflow on. Must belong to your organization.
Name
workflow_type
Type
string
Description
The type of workflow to create. Allowed values: daily_review or assign_user.

Workflow types

daily_review: Creates a daily recurrence trigger, a live feed segment review action, and a notification sent to the users linked to the segment.
assign_user: Creates a segment-based trigger and an assign user action based on the users linked to the segment.

Request

POST

/v3/workflows

curl -X POST https://api.bx.feedier.com/v3/workflows \
    -H "Authorization: Bearer {token}" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"segment_id": 715, "workflow_type": "daily_review"}'

Response

{
    "data": {
        "id": 123,
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Recommended - Daily Review",
        "status": "active",
        "team_id": 2,
        "is_automatic": true,
        "created_at": "2026-03-02T10:00:00.000000Z",
        "updated_at": "2026-03-02T10:00:00.000000Z",
        "nodes": [
            {
                "id": 1,
                "name": "recurrence",
                "type": "trigger",
                "settings": {
                    "on": "every_day",
                    "time": "09:00",
                    "time_cycle": "day",
                    "time_cycle_frequency": 1,
                    "ends": "never"
                },
                "created_at": "2026-03-02T10:00:00.000000Z",
                "updated_at": "2026-03-02T10:00:00.000000Z"
            },
            {
                "id": 2,
                "name": "live_feed_segment_review",
                "type": "action",
                "settings": {
                    "segment": {
                        "id": 715,
                        "name": "Recommended"
                    }
                },
                "created_at": "2026-03-02T10:00:00.000000Z",
                "updated_at": "2026-03-02T10:00:00.000000Z"
            },
            {
                "id": 3,
                "name": "message",
                "type": "notification",
                "settings": {
                    "emails": ["manager@example.com"],
                    "team_members": [{"id": 42}]
                },
                "created_at": "2026-03-02T10:00:00.000000Z",
                "updated_at": "2026-03-02T10:00:00.000000Z"
            }
        ]
    }
}

DELETE/v3/workflows/:id

Delete a workflow

This endpoint allows you to delete a workflow by its ID. Deleting a workflow also removes all associated nodes and executions.

Request

DELETE

/v3/workflows/123

curl -X DELETE https://api.bx.feedier.com/v3/workflows/123 \
    -H "Authorization: Bearer {token}"