curl --request POST \
  --url https://api.sandbox.nevermined.app/api/v1/organizations/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "user@example.com",
  "role": "Member"
}
'

{
  "success": true,
  "message": "User already a member of the organization",
  "walletResult": {
    "hash": "<string>",
    "userId": "<string>",
    "userWallet": "<string>",
    "alreadyMember": true
  }
}

{
  "success": true,
  "message": "User created and login successful",
  "walletResult": {
    "hash": "<string>",
    "userId": "<string>",
    "userWallet": "<string>",
    "alreadyMember": false,
    "nvmApiKey": "<string>",
    "isCustomer": true,
    "customerRecorded": true
  }
}

{
  "success": true,
  "message": "<string>",
  "walletResult": {
    "alreadyMember": false,
    "consentRequired": true
  }
}

{
  "code": "BCK.COMMON.0001",
  "httpStatus": 500,
  "message": "Unable to initialize Nevermined instance",
  "details": "Hash JWT is not signed by the node account",
  "hint": "Verify the wallet has sufficient balance and that the plan is active.",
  "docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
  "category": "integration",
  "retryable": true,
  "correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
  "uuid": "e-550e8400-e29b-41d4-a716-446655440000",
  "date": "2026-05-09T12:34:56.789Z",
  "params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}

{
  "code": "BCK.COMMON.0001",
  "httpStatus": 500,
  "message": "Unable to initialize Nevermined instance",
  "details": "Hash JWT is not signed by the node account",
  "hint": "Verify the wallet has sufficient balance and that the plan is active.",
  "docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
  "category": "integration",
  "retryable": true,
  "correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
  "uuid": "e-550e8400-e29b-41d4-a716-446655440000",
  "date": "2026-05-09T12:34:56.789Z",
  "params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}

{
  "code": "BCK.COMMON.0001",
  "httpStatus": 500,
  "message": "Unable to initialize Nevermined instance",
  "details": "Hash JWT is not signed by the node account",
  "hint": "Verify the wallet has sufficient balance and that the plan is active.",
  "docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
  "category": "integration",
  "retryable": true,
  "correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
  "uuid": "e-550e8400-e29b-41d4-a716-446655440000",
  "date": "2026-05-09T12:34:56.789Z",
  "params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}

General

Provision an account for the organization (member or customer)

Provisions a Nevermined identity (and Privy-managed wallet) for the given email under the caller’s organization. The as field selects the outcome:

member (default): adds a seat-consuming OrganizationMember with the requested role (defaults to Member), starting inactive pending an email-challenge confirmation. Returns 201 when the membership was created, or 200 when the user is already a member.
customer: white-label onboarding — no seat is consumed. role is ignored. The behaviour depends on whether the email already has a Nevermined identity:
- new account: recorded into the organization Customers CRM immediately (before any purchase) and the response returns a usable, scoped NVM API key (walletResult.nvmApiKey, 201) so the organization can transparently act for its own customer. The key is tagged to the caller’s organization, so the customer’s requests resolve to that workspace and their activity/purchases are attributed to it.
- existing account: no key is issued (account-takeover guard). An email challenge is sent to the owner and the response is 202 with walletResult.consentRequired = true; the organization cannot obtain a credential for an account it does not own without the owner’s consent.

Requires a Nevermined API key and organization admin privileges.

POST

organizations

account

curl --request POST \
  --url https://api.sandbox.nevermined.app/api/v1/organizations/account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "user@example.com",
  "role": "Member"
}
'

{
  "success": true,
  "message": "User already a member of the organization",
  "walletResult": {
    "hash": "<string>",
    "userId": "<string>",
    "userWallet": "<string>",
    "alreadyMember": true
  }
}

{
  "success": true,
  "message": "User created and login successful",
  "walletResult": {
    "hash": "<string>",
    "userId": "<string>",
    "userWallet": "<string>",
    "alreadyMember": false,
    "nvmApiKey": "<string>",
    "isCustomer": true,
    "customerRecorded": true
  }
}

{
  "success": true,
  "message": "<string>",
  "walletResult": {
    "alreadyMember": false,
    "consentRequired": true
  }
}

{
  "code": "BCK.COMMON.0001",
  "httpStatus": 500,
  "message": "Unable to initialize Nevermined instance",
  "details": "Hash JWT is not signed by the node account",
  "hint": "Verify the wallet has sufficient balance and that the plan is active.",
  "docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
  "category": "integration",
  "retryable": true,
  "correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
  "uuid": "e-550e8400-e29b-41d4-a716-446655440000",
  "date": "2026-05-09T12:34:56.789Z",
  "params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}

{
  "code": "BCK.COMMON.0001",
  "httpStatus": 500,
  "message": "Unable to initialize Nevermined instance",
  "details": "Hash JWT is not signed by the node account",
  "hint": "Verify the wallet has sufficient balance and that the plan is active.",
  "docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
  "category": "integration",
  "retryable": true,
  "correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
  "uuid": "e-550e8400-e29b-41d4-a716-446655440000",
  "date": "2026-05-09T12:34:56.789Z",
  "params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}

{
  "code": "BCK.COMMON.0001",
  "httpStatus": 500,
  "message": "Unable to initialize Nevermined instance",
  "details": "Hash JWT is not signed by the node account",
  "hint": "Verify the wallet has sufficient balance and that the plan is active.",
  "docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
  "category": "integration",
  "retryable": true,
  "correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
  "uuid": "e-550e8400-e29b-41d4-a716-446655440000",
  "date": "2026-05-09T12:34:56.789Z",
  "params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Email to provision, and the onboarding outcome (as).

The body is of type object.

Response

User was already a member of the organization; returns the existing wallet info.

success

boolean

Example:

true

message

string

Example:

"User already a member of the organization"

walletResult

object

Show child attributes

Overview

Agents

Plans

Access

x402

Credits

Delegation

Router

Payment Methods

Organizations

Authentication

Provision an account for the organization (member or customer)

Authorizations

Body

Response