Skip to Content
Members

Add a member to the workspace

POST
/api/v1/members

Adds a member of the organization to this workspace with the role roleId, and returns the new member. To list roles, call GET /api/v1/roles.

If the email address is on a domain that your organization manages through SSO, and no account has it yet, the request creates the account, makes it a member of the organization and this workspace, and returns it. The person signs in through SSO, so there's no invitation to accept.

Otherwise, if no member of the organization has the email address, the request returns 404. To invite someone who isn't a member of the organization yet, call POST /api/v1/member-invites.

Permission required: MANAGE_WORKSPACE_MEMBERS on the workspace.

Authorization

headerAuthorizationBearer <token>

API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.

Header Parameters

Sajn-Version?string

API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.

Value in"2026-09""2026-10"
Sajn-Workspace?string

ID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.

Idempotency-Key?string

Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.

Lengthlength <= 255

Request Body

Body

application/json
  1. body

Add an organization member to the workspace

email*string

Email address of a member of the organization

Match^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Formatemail
roleId*string

Workspace role ID. To list roles, call GET /api/v1/roles.

Response Body

Workspace member

application/json
  1. response

Workspace member

id*string

User ID of the member. Address the member with it in /api/v1/members/{userId}.

email*string
name*|

Full name. Null when the user has no name.

role*

Workspace role

status*string

ACTIVE once the member has signed in at least once

Value in"ACTIVE""INACTIVE"
lastActiveAt*|
Formatdate-time
joinedAt*string

When the user was added to the workspace

Formatdate-time
Example Request
curl -X POST 'https://app.sajn.se/api/v1/members' \  -H 'Content-Type: application/json' \  -d '{  "email": "robin@example.com",  "roleId": "cm4k2x9p10026abcd1234efgh"}'
Example Response
{  "id": "cm4k2x9p10002abcd1234efgh",  "email": "robin@example.com",  "name": "Robin Ek",  "role": {    "id": "cm4k2x9p10026abcd1234efgh",    "name": "Robin Ek"  },  "status": "ACTIVE",  "lastActiveAt": "2026-09-28T09:15:00.000Z",  "joinedAt": "2026-01-12T08:00:00.000Z"}

Was this page helpful?