# invite_member

Invite a user to a workspace by email, creating the Layer user if needed.

The invited user is added with the given role (default: member) and an ACTIVE  
membership; they receive an invite notification. Fails if the workspace has  
invites disabled or the user is already a member. Requires workspace member-edit  
permission.

## Parameters

| Parameter             | Type           | Default | Description                                                                                                                                                                                                |
| --------------------- | -------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| workspace\_idrequired | string (uuid)  | —       | The workspace to invite the user into.                                                                                                                                                                     |
| emailrequired         | string (email) | —       | Email address of the person to invite. A Layer user is created if none exists.                                                                                                                             |
| role                  | enum           | member  | Workspace role to grant. One of: admin, settings\_admin, editor, art\_director, artist, member. Defaults to member (least privilege).One of: admin, editor, settings\_admin, art\_director, artist, member |