---
title: "Create Organization User Buyer Agent"
method: POST
path: "/api/v1/organizations/users/{userId}/agents/buyer"
---

# Create Organization User Buyer Agent

`POST /api/v1/organizations/users/{userId}/agents/buyer`

## Request

- Base URL: `https://api.skyfire.xyz`
- URL: `https://api.skyfire.xyz/api/v1/organizations/users/{userId}/agents/buyer`
- Auth: API key in header `skyfire-api-key`

As an Organization Admin, create an ungrouped buyer agent for an organization user, with a wallet and one API key.

## Path parameters

- `userId` string, uuid, required

## Request body

- object
  - `displayName` string, required: Display name of the new agent, shown to sellers as `aid.name`. Printable ASCII with at least one non-space character, 1 to 100 characters. Must be free among the user's active agents and not match an active agent group in your organization. e.g. `"Procurement Agent"`

## Response `200`

Ok

- object
  - `id` string, required: Unique identifier of the created agent.
  - `apiKey` string, required: API key for the agent. Returned only in this response and cannot be retrieved again, store it securely.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `22cbec9d7630`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/changes/api/v1/organizations/users/:userId/agents/buyer/post.md)

---

[API](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis.md) - [All operations](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/revisions/22cbec9d7630?raw)