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

# Invite Member

Invite a new user to join your organization via email.

### Request

<ParamField header="X-Organization-Id" type="string" required>
  The unique identifier of the organization.
</ParamField>

<ParamField body="email" type="string" required>
  The email address of the user to invite.
</ParamField>

<ParamField body="role" type="string" required>
  The role to assign to the invited user. Must be one of `admin`, `agent_manager`, or `user`.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates whether the invitation was successfully created.
</ResponseField>

<ResponseField name="invite_id" type="string">
  The unique identifier for the created invitation.
</ResponseField>

<ResponseField name="invite_link" type="string">
  The signup link that can be shared with the invited user.
</ResponseField>

<ResponseField name="message" type="string">
  A descriptive message about the operation result.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "invite_id": "inv_xyz789",
    "invite_link": "https://app.getbutter.ai/signup?invite=inv_xyz789&email=newuser@example.com",
    "message": "Invitation sent to newuser@example.com"
  }
  ```
</ResponseExample>