List Automations

This page documents the OpenSend-owned API contract for GET /automations.

GET /automations

Authentication

Use a full-access OpenSend API key in the Authorization header. Dashboard session cookies are not API credentials for this root public API route.

Authorization: Bearer os_YOUR_API_KEY

When to use it

Use this route to inspect automations that can react to custom events and drive lifecycle messaging. Results are tenant-scoped and include dashboard-friendly summary fields such as step count and last run summary when available.

Parameters

• limit — optional page size from 1 to 100.
• after — optional cursor.
• status — optional draft, enabled, or disabled filter.
• search — optional name search string.

Response

{
  "object": "list",
  "data": [
    {
      "object": "automation",
      "id": "auto_123",
      "name": "Welcome flow",
      "status": "enabled",
      "trigger_event_name": "user.signed_up",
      "step_count": 3,
      "last_run": null
    }
  ],
  "has_more": false
}

Errors

Missing, malformed, or insufficient API keys fail before tenant data is loaded. A resource from another tenant is never included in the list.