Docs

Overview

Contacts

Topics

Segments

Forms

API Keys

Automations

Broadcasts

Contact Properties

Events

Fire custom eventPOST

Inbox

Marketing Emails

Sending Domains

Transactional Emails

Automations

GET

List Automations

GET /v1/automations

Retrieve a paginated list of all automations in your workspace.

Use Cases:

View all automation workflows and their statuses
Monitor active automations
Build automation management dashboards
Audit automation configurations
Track automation versions

Behavior:

Returns automations in reverse chronological order (newest first)
Uses cursor-based pagination for efficient retrieval
Includes automation metadata, trigger configuration, and status
Shows only root automations (not version variants)
Maximum 100 automations per request

Required Scope: read:automations

Response Includes:

Automation ID, name, and description
Current status (DRAFT, PUBLISHED, ARCHIVED)
Trigger type and configuration
Workflow nodes and edges
Version number and parent ID
Statistics and timestamps

Query parameters

limitinteger

Number of items to return (default: 20, max: 100)

afterstring

Cursor for pagination - ID of the last item from the previous page

beforestring

Cursor for reverse pagination - ID of the first item from the next page

Response

200Successfully retrieved paginated list of automations with metadata and trigger configuration

objectstringrequired

hasMorebooleanrequired

dataobject[]required

Request

curl -X GET "https://api.kibamail.com/v1/automations" \
  -H "Authorization: Bearer kb_your_api_key" \
  -H "Content-Type: application/json"

Response

Successfully retrieved paginated list of automations with metadata and trigger configuration

{
  "object": "string",
  "hasMore": true,
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": null,
      "status": "DRAFT",
      "version": 1,
      "parentId": null,
      "trigger": {
        "type": "string",
        "config": {}
      },
      "nodes": [
        null
      ],
      "edges": [
        null
      ],
      "stats": null,
      "publishedAt": null,
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}

Copyright © 2026 Kibamail.·Privacy Policy