INinstantly
AIInboxManager

List AI Inbox Managers

Changed on

List the AI Inbox Managers of the workspace, newest first.

Requires one of the following scopes: ai_agents:read, ai_agents:all, all:read, all:all

get/api/v2/ai-agents/inbox-manager

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/ai-agents/inbox-manager
  • Auth
    HTTP bearer

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring uuid
Example:01a19e6d-9406-7b85-87df-09dcfe4643fa

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

status0 | 1
Example:1

Filter by agent status.

searchstring
Example:Support inbox

Filter agents whose name contains this text (case-insensitive).

Response

The AI Inbox Managers of the workspace

next_starting_afterstring uuid

Pass as starting_after to fetch the next page. Absent on the last page.

Example response

{
  "items": [
    {
      "id": "01a19e6d-50a9-79e8-8f91-951a76adc9d7",
      "organization_id": "01a19e6d-50a9-79e8-8f91-951b651b4747",
      "name": "Test AI Agent",
      "payload": {
        "configuration_type": 1,
        "tags": [
          "default"
        ],
        "handle_followup": true,
        "respond_to_automatic_emails": true,
        "handle_objections": true,
        "integrations": {
          "slack": {
            "connectionId": "01a19e6d-50a8-744f-af36-23f26c8472c7",
            "connectionName": "My Connection"
          }
        },
        "no_show": {
          "enabled": true,
          "max_followups": 3
        },
        "trigger_on_labels": [
          1,
          -1
        ],
        "trigger_on_labels_mode": "include",
        "monthly_credit_budget": 1000,
        "followup_business_days_only": true,
        "followup_delay": 3,
        "followup_delay_unit": "days"
      },
      "type": 1,
      "timestamp_created": "2026-11-02T22:42:06.633Z",
      "timestamp_updated": "2026-11-02T22:42:06.633Z",
      "status": 1,
      "created_by": "01a19e6d-50a9-79e8-8f91-951cd6f29219",
      "description": "Optional agent description",
      "metadata": {
        "tags": {
          "tag-id": {
            "id": "tag-id",
            "label": "Tag Label"
          }
        }
      }
    }
  ],
  "next_starting_after": "01a19e6d-9406-7b85-87df-09dd580422ef"
}

Changes