---
title: "Create Invite Link"
method: POST
path: "/v2/workspaces/{workspace_id}/invite-links"
tags: ["v2 - Workspace Shares"]
---

# Create Invite Link

`POST /v2/workspaces/{workspace_id}/invite-links`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/workspaces/{workspace_id}/invite-links`
- Auth: HTTP bearer

Create an invite link for a workspace.

Access: Owner or admin (requires MEMBERS_INVITE permission).
Link expires in 7 days.

## Path parameters

- `workspace_id` string, required

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Request body

- CreateInviteLinkRequest
  - `auto_accept` boolean: If true, joiners are added immediately. If false, requires owner approval.
  - `max_uses` integer, nullable: Maximum number of uses. None = unlimited.

## Response `201`

Successful Response

- InviteLinkResponse
  - `token` string, required
  - `invite_url` string, required
  - `workspace_id` string, required
  - `auto_accept` boolean, required
  - `max_uses` integer, nullable, required
  - `use_count` integer, required
  - `expires_at` string, required
  - `revoked` boolean, required
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)