---
title: "POST /api/workspaces/invitations/workspace/{workspace_id}/"
method: POST
path: "/api/workspaces/invitations/workspace/{workspace_id}/"
tags: ["Workspace invitations"]
---

# POST /api/workspaces/invitations/workspace/{workspace_id}/

`POST /api/workspaces/invitations/workspace/{workspace_id}/`

Creates a new workspace invitations for an email address if the authorized user has admin rights to the related workspace. An email containing a sign up link will be send to the user.

## Path parameters

- `workspace_id` integer, required

## Request body

- CreateWorkspaceInvitation
  - `email` string, email, required — The email address of the user that the invitation is meant for. Only a user with that email address can accept it.
  - `permissions` string — The permissions that the user is going to get within the workspace after accepting the invitation.
  - `base_url` string, uri, required — The base URL where the user can publicly accept his invitation.The accept token is going to be appended to the base_url (base_url '/token').
  - `captcha_token` string — The captcha response token, required when captcha is enabled.

## Response `200`

- WorkspaceInvitation
  - `id` integer, required
  - `workspace` integer, required — The workspace that the user will get access to once the invitation is accepted.
  - `email` string, email, required — The email address of the user that the invitation is meant for. Only a user with that email address can accept it.
  - `permissions` string — The permissions that the user is going to get within the workspace after accepting the invitation.
  - `created_on` string, date-time, required

## Other responses

- `400`
- `404`
- `429` — No response body

## Changes

- **2026-08-05** `0c490e5b0c7f` — 1 warning, 4 info
  - added the new `ERROR_CAPTCHA_VERIFICATION_FAILED` enum value to the `error` response property for the response status `400`
  - added the new optional request property `captcha_token` (media type: application/json)
  - added the new optional request property `captcha_token` (media type: application/x-www-form-urlencoded)
  - added the new optional request property `captcha_token` (media type: multipart/form-data)
  - …1 more

[Change history](https://skmtc.dev/baserow/apis/baserow-api-spec/changes/api/workspaces/invitations/workspace/:workspace_id/post.md)

---

[API](https://skmtc.dev/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.dev/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/revisions/f3396317d932/schema)