# Add member to business

Add a user as a member of the business. Requires BUSINESS auth (min role: ADMIN) or TENANT admin.

Endpoint: POST /businesses/{businessId}/members
Version: 2.2.2
Security: projectKey, authJWT

## Path parameters:

  - `businessId` (string, required)

## Request fields (application/json):

  - `userId` (string, required)
    The user ID to add as a member

  - `role` (string, required)
    The role to assign (permissions derived from role)
    Enum: "OWNER", "ADMIN", "EDITOR", "VIEWER"

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for this membership

  - `userId` (string, required)
    The user ID who has access to this business

  - `businessId` (string, required)
    The business ID this membership belongs to

  - `role` (string, required)
    The role the user has in this business. Permissions are derived from role.
    Enum: "OWNER", "ADMIN", "EDITOR", "VIEWER"

  - `createdAt` (string)
    When the membership was created

  - `updatedAt` (string)
    When the membership was last updated

  - `included` (object)
    Included related entities. Only populated when include parameter is specified.

  - `included.user` (object)

  - `included.user.id` (string, required)

  - `included.user.email` (object)

  - `included.user.identifierEmail` (string, required)
    Universal identifier email for deterministic operations. Generated from B2B inputs (email, externalId) for wallet salt generation and external integrations.
    Example: "user123@user.pers.internal"

  - `included.user.firstName` (object,null, required)
    User first name

  - `included.user.lastName` (object,null, required)
    User last name

  - `included.user.externalId` (object,null, required)
    User external id

  - `included.user.instagramAccountId` (object,null, required)
    Instagram account id

  - `included.user.googleAccountName` (object,null, required)
    Google account name

  - `included.user.customData` (object, required)
    Custom data

  - `included.user.publicProfile` (object,null, required)
    Public profile data

  - `included.user.isActive` (boolean, required)
    Is active

  - `included.user.currentSigningAccountId` (object)
    Current active signing account ID for external wallet operations

  - `included.user.wallets` (array, required)
    User-owned counterfactual smart contract wallets that can receive tokens

  - `included.user.wallets.id` (string, required)
    Unique identifier for the internal wallet

  - `included.user.wallets.ownerType` (number, required)
    Owner type for polymorphic ownership
    Enum: {"USER":"user","BUSINESS":"business","TENANT":"tenant","SYSTEM":"system","EXTERNAL":"external"}

  - `included.user.wallets.ownerId` (string, required)
    Owner ID for polymorphic ownership
    Example: "user_123"

  - `included.user.wallets.walletManagementType` (number, required)
    Type of internal wallet
    Enum: {"CUSTODIAL":"custodial","NON_CUSTODIAL":"non-custodial"}

  - `included.user.wallets.address` (string, required)
    CREATE2 generated address that can receive tokens

  - `included.user.wallets.chainId` (number, required)
    Blockchain network chain identifier

  - `included.user.wallets.status` (number, required)
    Current status of the wallet
    Enum: {"PENDING":"pending","ACTIVE":"active","SUSPENDED":"suspended","ARCHIVED":"archived"}

  - `included.user.wallets.ownerSigningAccountId` (object,null)
    ID of signing account that owns this internal wallet

  - `included.user.wallets.tags` (array, required)
    Tags associated with the wallet for categorization

  - `included.user.wallets.createdAt` (string, required)
    Timestamp when the wallet was created

  - `included.user.wallets.updatedAt` (string, required)
    Timestamp when the wallet was last updated

  - `included.user.createdAt` (string, required)
    Timestamp when the user was created

  - `included.user.updatedAt` (string,null, required)
    Timestamp when the user was last updated

  - `included.user.accountAddress` (object,null, required)
    User account address

  - `included.business` (object)

  - `included.business.id` (string, required)
    The id of the business, this is unique and will be used to identify the business.

  - `included.business.email` (object,null, required)
    The email of the business, this is unique and will be used to identify the business.

  - `included.business.wallets` (array, required)
    Business-owned counterfactual smart contract wallets that can receive tokens

  - `included.business.businessLegalName` (object,null, required)
    The legal name of the business, this is the name that will be used for legal purposes.

  - `included.business.displayName` (object,null, required)
    The display name of the business, this is the name that will be shown to the public.

  - `included.business.description` (object,null, required)
    The description of the business, this is the description that will be shown to the public.

  - `included.business.shortDescription` (object,null, required)
    The short description of the business, this is the description that will be shown to the public.

  - `included.business.websiteUrl` (object,null, required)
    The website of the business, this is the website that will be shown to the public.

  - `included.business.imageUrl` (object,null, required)
    The image of the business, this is the image that will be shown to the public.

  - `included.business.streetAddress` (object,null, required)
    The address of the business, this is the address that will be shown to the public.

  - `included.business.city` (object,null, required)
    The city of the business, this is the city that will be shown to the public.

  - `included.business.postalCode` (object,null, required)
    The postal code of the business, this is the postal code that will be shown to the public.

  - `included.business.coordsLatitude` (object,null, required)
    The latitude of the business, this is the latitude that will be shown to the public.

  - `included.business.coordsLongitude` (object,null, required)
    The longitude of the business, this is the longitude that will be shown to the public.

  - `included.business.businessType` (object,null, required)
    The business type of the business, this is the business type that will be shown to the public.

  - `included.business.businessType.id` (number)
    Business type id

  - `included.business.businessType.name` (string,null, required)
    Business type name

  - `included.business.businessType.description` (string,null, required)
    Business type description

  - `included.business.businessType.code` (string,null, required)
    Business type code

  - `included.business.businessType.iconUrl` (string,null, required)
    Business type icon url

  - `included.business.isActive` (boolean, required)
    The status of the business, this is the status that will be shown to the public.

  - `included.business.canMintToken` (boolean, required)
    The ability to mint token for the business, this is the ability that will be shown to the public.

  - `included.business.canChargeToken` (boolean, required)
    The ability to charge token for the business, this is the ability that will be shown to the public.

  - `included.business.canManageUsers` (boolean, required)
    The ability to manage users for the business, this is the ability that will be shown to the public.

  - `included.business.canReceiveDonation` (boolean, required)
    The ability to receive donation for the business, this is the ability that will be shown to the public.

  - `included.business.accountAddress` (object,null, required)
    The address of the business, this is the address that will be shown to the public.


## Response 403 fields