Add a member to the workspace
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.
AuthorizationBearer <token>API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.
Sajn-Version?stringAPI 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.
"2026-09""2026-10"Sajn-Workspace?stringID 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?stringMakes 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.
length <= 255Body
application/json- body
Add an organization member to the workspace
email*stringEmail address of a member of the organization
^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$emailroleId*stringWorkspace role ID. To list roles, call GET /api/v1/roles.
Workspace member
application/json- response
Workspace member
id*stringUser ID of the member. Address the member with it in /api/v1/members/{userId}.
email*stringname*|Full name. Null when the user has no name.
role*Workspace role
status*stringACTIVE once the member has signed in at least once
"ACTIVE""INACTIVE"lastActiveAt*|date-timejoinedAt*stringWhen the user was added to the workspace
date-timecurl -X POST 'https://app.sajn.se/api/v1/members' \ -H 'Content-Type: application/json' \ -d '{ "email": "robin@example.com", "roleId": "cm4k2x9p10026abcd1234efgh"}'{ "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?