---
title: "Add a New Agent"
method: POST
path: "/v1/workspaces/{workspace_id}/inbox_members"
tags: ["Inboxes"]
---

# Add a New Agent

`POST /v1/workspaces/{workspace_id}/inbox_members`

## Request

- Base URL: `https://api.oxvo.com`
- URL: `https://api.oxvo.com/v1/workspaces/{workspace_id}/inbox_members`
- Auth: API key in header `api_access_token`

Add a new Agent to Inbox

## Request body

- object
  - `inbox_id` integer, required: The ID of the inbox
  - `user_ids` integer[], required: IDs of users to be added to the inbox

## Response `200`

Success

- object
  - `payload` Agent[]: Array of all active agents
    - `id` integer
    - `account_id` integer
    - `availability_status` 'available' | 'busy' | 'offline': The availability status of the agent computed by OXVO.
    - `auto_offline` boolean: Whether the availability status of agent is configured to go offline automatically when away.
    - `confirmed` boolean: Whether the agent has confirmed their email address.
    - `email` string: The email of the agent
    - `available_name` string: The available name of the agent
    - `name` string: The name of the agent
    - `role` 'agent' | 'administrator': The role of the agent
    - `thumbnail` string: The thumbnail of the agent
    - `custom_role_id` integer, nullable: The custom role id of the agent

## Other responses

- `403`: Access denied
- `404`: Inbox not found
- `422`: User must exist

---

[API](https://skmtc.dev/oxvo/apis/oxvo-apis.md) · [All operations](https://skmtc.dev/oxvo/apis/oxvo-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oxvo/apis/oxvo-apis/revisions/9a8448cbd1fe?raw)