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

# Invite Member

> Invite a user to join your organization

Sends an email invitation to join your organization (business). When the invited user clicks the link:

1. They are taken to the sign-up page
2. After creating an account, they are automatically added to the organization
3. They are redirected to the dashboard

## Request Body

<ParamField body="organization_id" type="string" required>
  The Clerk organization ID
</ParamField>

<ParamField body="email_address" type="string" required>
  Email address to invite
</ParamField>

<ParamField body="role" type="string" default="org:member">
  Role for the invited user: `"org:admin"` or `"org:member"`
</ParamField>

<ParamField body="redirect_url" type="string">
  URL to redirect after signup (defaults to `/dashboard`)
</ParamField>

## Response

<ResponseField name="status" type="string">
  `"success"` if invitation was sent
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable confirmation message
</ResponseField>

<ResponseField name="invitation_id" type="string">
  Clerk invitation ID for tracking
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://searchcompany-main.up.railway.app/api/organizations/invite \
    -H "Content-Type: application/json" \
    -d '{
      "organization_id": "org_2abc123",
      "email_address": "teammate@company.com",
      "role": "org:member"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "status": "success",
    "message": "Invitation sent to teammate@company.com",
    "invitation_id": "inv_2def456"
  }
  ```
</ResponseExample>