> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caret.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 초대 생성

> 워크스페이스에 새 초대를 생성합니다

### Body

<ParamField body="email" type="string" required>
  초대할 사람의 이메일 주소.
</ParamField>

<ParamField body="role" type="string" default="member">
  초대받는 사람에게 할당할 역할. `admin`, `member` 중 하나.
</ParamField>

<ParamField body="isUrlInvite" type="boolean" default="false">
  URL 기반 초대를 생성할지(`true`) 이메일 초대를 보낼지(`false`) 여부.
</ParamField>

### 응답

<ResponseField name="invite" type="object">
  <Expandable title="Invite">
    <ResponseField name="id" type="string">
      초대의 고유 식별자.
    </ResponseField>

    <ResponseField name="email" type="string">
      초대받는 사람의 이메일 주소.
    </ResponseField>

    <ResponseField name="code" type="string">
      초대 코드.
    </ResponseField>

    <ResponseField name="role" type="string">
      초대받는 사람에게 할당된 역할.
    </ResponseField>

    <ResponseField name="expiresAt" type="string">
      초대가 만료되는 ISO8601 타임스탬프.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      초대가 생성된 ISO8601 타임스탬프.
    </ResponseField>

    <ResponseField name="isUrlInvite" type="boolean">
      URL 기반 초대인지 여부.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request POST \
    --url https://api.caret.so/v1/invites \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
    "email": "user@example.com",
    "role": "member",
    "isUrlInvite": false
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "invite": {
      "id": "inv_123",
      "email": "user@example.com",
      "code": "abc123xy",
      "role": "member",
      "expiresAt": "2026-02-27T10:00:00Z",
      "createdAt": "2026-01-28T10:00:00Z",
      "isUrlInvite": false
    }
  }
  ```
</ResponseExample>