INinstantly
WorkspaceMember

Create workspace member

Changed on

Requires one of the following scopes: workspace_members:create, workspace_members:all, all:create, all:all

post/api/v2/workspace-members

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/workspace-members
  • Auth
    HTTP bearer

Request body

emailstring email required

Email address of the workspace member

user_emailstring email nullable

Email address of the user

nicknamestring nullable

Private workspace member nickname visible only to the workspace owner

role'owner' | 'admin' | 'editor' | 'view' | 'client' required

THe role of the workspace member defining their access level. While the "owner" role is listed in the enum, it cannot be created via the API, and is only assigned to the user who creates the workspace.

permissionsstring[] nullable

The permissions for this workspace member. Used in the app to restrict access to certain sections

Example request

{
  "email": "user@example.com",
  "user_email": "user@example.com",
  "nickname": "Finance lead",
  "role": "editor",
  "permissions": [
    "unibox.all"
  ]
}

Response

The Workspace Member

idstring uuid required

Unique identifier for the workspace member

emailstring email required

Email address of the workspace member

user_idstring uuid required

User ID of the workspace member

user_emailstring email nullable

Email address of the user

nicknamestring nullable

Private workspace member nickname visible only to the workspace owner

picture_urlstring nullable

URL of the profile picture the user uploaded, if any. Returned when listing workspace members.

role'owner' | 'admin' | 'editor' | 'view' | 'client' required

THe role of the workspace member defining their access level. While the "owner" role is listed in the enum, it cannot be created via the API, and is only assigned to the user who creates the workspace.

timestamp_createdstring date-time required

Timestamp when the workspace member was created

workspace_idstring uuid required

ID of the workspace this member belongs to

acceptedboolean required

Whether the member has accepted the workspace invitation

issuer_idstring uuid nullable

ID of the user who added this member to the workspace

permissionsstring[] nullable

The permissions for this workspace member. Used in the app to restrict access to certain sections

Example response

{
  "id": "01a19e6e-27ba-7bbc-892a-bc921a3944e8",
  "email": "user@example.com",
  "user_id": "01a19e6e-27ba-7bbc-892a-bc9328f2127a",
  "user_email": "user@example.com",
  "nickname": "Finance lead",
  "name": {
    "first": "John",
    "last": "Smith"
  },
  "picture_url": "https://example.com/profile-picture.png",
  "role": "editor",
  "timestamp_created": "2026-11-02T22:43:01.690Z",
  "workspace_id": "01a19e6e-27ba-7bbc-892a-bc9413de2bec",
  "issuer_id": "01a19e6e-27ba-7bbc-892a-bc953434e01c",
  "permissions": [
    "unibox.all"
  ]
}

Changes

  • c781051105a8Revision changes
    • warning

      added the new websiteChat.manage enum value to the / response property for the response status

    • warning

      added the new websiteChat.view enum value to the / response property for the response status

    • info

      added the new websiteChat.manage enum value to the request property /

    • info

      added the new websiteChat.view enum value to the request property /

    • info

      added the optional property to the response with the status