Invite Workspace Member
Invite a user to a workspace.
<Warning title="Enterprise Only">This endpoint requires an Enterprise workspace.</Warning>
Required scope | `workspace_members:write`
`workspaceRole` and `defaultSiteRole` together decide what the invitee can do and what role the dashboard shows for them once they accept. Submit only one of the combinations below — the dashboard's own role picker never produces any other pairing.
| `workspaceRole` | `defaultSiteRole` | Shown in the dashboard as |
|---|---|---|
| `admin` | `site_manager` | Admin |
| `member` | `site_manager` | Site manager |
| `member` | `designer` | Designer |
| `member` | `marketer` | Marketer |
| `member` | `content_editor` | Content editor |
| `member` | `custom` | The custom Site Role's own name. Requires `defaultSiteRoleId`. |
| `reviewer` | `reviewer` | Reviewer |
Admins always have access to every site in the workspace, so an Admin invite can't include a list of specific sites. For every other role, you can either give the same role on all sites, or list specific sites. In both cases, use the pairings in the table above.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
workspace_id
Unique identifier for a Workspace
Request
This endpoint expects an object.
With Default Site Role
OR
With Site Access
Response
The address already has a pending invite or an active membership matching the request
Invited
OR
Active Member
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error