---
title: "Create a new AI agent account"
method: POST
path: "/v0.2.4/agents/create"
tags: ["Agents"]
---

# Create a new AI agent account

`POST /v0.2.4/agents/create`

Creates an agent sub-account with APort passport, multicurrency wallet, and payment pointer

## Request body

- object
  - `name` string, required — Agent name
  - `description` string — Agent description
  - `email` string, email — Agent email (auto-generated if not provided)
  - `subAccount` string — Sub-account identifier
  - `limits` object — Transaction limits
    - `USD` object
      - `maxPerTx` integer
      - `dailyCap` integer
    - `CAD` object
      - `maxPerTx` integer
      - `dailyCap` integer
    - `NGN` object
      - `maxPerTx` integer
      - `dailyCap` integer
    - `MXN` object
      - `maxPerTx` integer
      - `dailyCap` integer
    - `refundAmountMaxPerTx` integer — Maximum refund amount per transaction
    - `refundAmountDailyCap` integer — Daily refund cap
    - `approvalRequired` boolean
  - `capabilities` union[] — Agent capabilities (finance.* or wallet.* only)
    - union
      - string
      - object
        - `id` string
        - `params` object
  - `regions` string[] — Allowed regions (ISO country codes)
  - `meta` object — Additional metadata
  - `interledgerWalletAddress` string — Custom Interledger wallet address/payment pointer
  - `initialFunding` union — Initial funding to transfer from parent wallet
    - number — Initial funding amount (0-1000000)
    - string — Initial funding as string
    - object
      - `amount` number
      - `currency` string

## Response `200`

Agent created successfully

- object
  - `status` string
  - `data` object
    - `uid` string
    - `name` string
    - `email` string
    - `paymentPointer` string
    - `aportPassportId` string
    - `aportDID` string
    - `assuranceLevel` string

## Other responses

- `400` — Validation error in the request.
- `401` — Access to this resource is not available for unauthenticated users.
- `500` — Indicates an internal server error.

---

[API](https://skmtc.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/revisions/227751df36a0/schema)