As an Organization Admin, create a new user in your organization.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Authenticate with an Organization Admin User API key, sent in the
skyfire-api-key header. Keys belonging to callers whose organization role is
ADMIN are accepted; a MEMBER key, or any Agent API
key, is rejected with 401.
The new user is always created in your organization. It is derived from
the API key, and there is no orgId field in the request body.
The role you assign
role you assignrole | Result |
|---|---|
MEMBER | Standard organization user. |
ADMIN | Organization Admin. Additionally receives a user API key, returned once as userApiKey. |
What this call creates
A single request creates:
- The organization user.
- A buyer agent named
Buyer 1, with a wallet. - An API key for that buyer agent, returned as
buyerAgent.apiKey. - If
roleisADMIN, an Organization Admin User API key, returned asuserApiKey.
If any step fails, the whole transaction is rolled back and no user is created.
buyerAgent.apiKeyanduserApiKeyare returned only in this responseand cannot be retrieved again. Store them securely before discarding the
response.
For role: "MEMBER", userApiKey is omitted from the response body
entirely. It is not returned as null.

