---
title: "Connect business-management agent"
method: POST
path: "/v1/owner/agents"
tags: ["Business Owner"]
---

# Connect business-management agent

`POST /v1/owner/agents`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/owner/agents`
- Auth: HTTP bearer

Connect one owner-supplied external management agent with an explicit least-privilege action scope. Omitted, empty, duplicate, or unknown actions are rejected; Loppee never infers full access. The human owner and recent-second-factor gates remain authoritative.

## Request body

- object
  - `business_id` string, required
  - `name` string, required
  - `actions` string[], required

## Response `200`

Connect business-management agent response

- object: Connected management agent; raw key is returned once.

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `409`: ErrorResponse
- `413`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)