INinstantly
AIInboxManager

Create an AI Inbox Manager

Changed on

Create a new AI Inbox Manager with its configuration and optional initial guidance, saved together. The agent is created active. Including guidance also requires the guidance creation scope.

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

post/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

Request body

namestring required

Name of the AI Inbox Manager

descriptionstring

Optional description for the AI Inbox Manager

Example request

{
  "name": "My Inbox Manager",
  "payload": {
    "configuration_type": 1,
    "tags": [
      "default"
    ],
    "handle_followup": true,
    "respond_to_automatic_emails": true,
    "handle_objections": true,
    "integrations": {
      "slack": {
        "connection_id": "0195b1a5-3b1d-7b6e-9c1a-2f7a4b0c1d2e",
        "enabled": true
      }
    },
    "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"
  },
  "description": "Handles replies for the EU campaigns"
}

Response

The created AI Inbox Manager

idstring uuid required

Unique identifier for the AI agent

organization_idstring uuid required

Organization ID

namestring required

Name of the AI Agent

type1 | 2 | 3 | 4 | 6 | 7 | 8 | 9 | 10 | 11 nullable

Type of the AI Agent

timestamp_createdstring required

Timestamp when the AI agent was created

timestamp_updatedstring required

Timestamp when the AI agent was updated

status-1 | 0 | 1 required

Status of the AI Agent

is_auto_createdboolean nullable

Whether the AI agent was auto-created

created_bystring uuid nullable

User ID who created the AI agent

descriptionstring nullable

Description of the AI agent

Example response

{
  "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"
      }
    }
  }
}

Changes