Users

A user represents a person (member) in nullplatform. Users receive roles, and those roles take effect through grants tied to specific resources.

Prerequisites

You need an Admin role at the Organization level to create users.

Create users

You can create users using the UI, CLI, or API.

UI

1. Log in to nullplatform as an admin user.
2. Navigate to Team management.
3. Click + Invite new member.
4. Fill in the user details, assign permissions, and click Send invite.

CLI

To create a user with the API, send a POST request to the User endpoint. Here’s an example:

np user create \
--body '{
  "email": "alex.doe@email.com",
  "first_name": "Alex",
  "last_name": "Doe",
  "organization_id": 1234,
  "avatar": "https://my-avatar-url.com",
  "send_invite": true  //Optional field; defaults to `true`
}'

cURL

To create a user with the API, send a POST request to the User endpoint. Here’s an example:

curl -L 'https://api.nullplatform.com/user' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>' \
--data-raw '{
  "email": "alex.doe@email.com",
  "first_name": "Alex",
  "last_name": "Doe",
  "organization_id": 1234,
  "avatar": "https://my-avatar-url.com",
  "send_invite": true  //Optional field; defaults to `true`
}'

The user will receive an invitation email to join nullplatform.

Pre-provision users before first SSO login

You can create users before their first SSO login so you can assign roles and grants in advance. This is useful when you want access in place on day one and you do not want to send an invitation email.

To pre-provision a user, create the user with send_invite=false. See Create a user for the full request and response schema.

ℹ️ Note: You can’t pre-provision users from the UI. Use the API or CLI instead.

CLI

np user create \
--body '{
  "email": "alex.doe@email.com",
  "first_name": "Alex",
  "last_name": "Doe",
  "organization_id": 1234,
  "send_invite": false
}'

cURL

curl -L -X POST 'https://api.nullplatform.com/user' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>' \
-d '{
  "email": "john.doe@email.com",
  "first_name": "John",
  "last_name": "Doe",
  "organization_id": 1234,
  "send_invite": false
}'

important

Set send_invite to false to avoid sending an invitation email.

About send_invite

• send_invite is a boolean field on user creation.
• The default value is true.
• When set to false, nullplatform does not send an invitation email.