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

# Invite Seller Member

> Invite a new member to a seller's team by email.

Creates a member invite for the given email and role.

## Path parameters

<ParamField path="id" type="string" required>The seller's ID.</ParamField>

## Body parameters

<ParamField body="email" type="string" required>Email address to invite.</ParamField>
<ParamField body="role_id" type="string" required>ID of the role assigned once the invite is accepted.</ParamField>

## Response

<ResponseField name="member_invite" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="string">The invite's ID.</ResponseField>
    <ResponseField name="email" type="string">Invited email address.</ResponseField>
    <ResponseField name="role_id" type="string">Role assigned on acceptance.</ResponseField>
    <ResponseField name="accepted" type="boolean">Whether the invite was accepted.</ResponseField>
    <ResponseField name="token" type="string">Token used to accept the invite.</ResponseField>
    <ResponseField name="expires_at" type="string">When the invite expires.</ResponseField>
    <ResponseField name="created_at" type="string">Creation timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/members/invite' \
    -H 'Authorization: Bearer <token>' \
    -H 'Content-Type: application/json' \
    -d '{"email": "new.member@acme.co", "role_id": "role_01HXYZROLEAA"}'
  ```

  ```ts JS Client theme={null}
  const { member_invite } = await client.admin.sellers.$id.members.invite.mutate({
    $id: "sel_01HXYZABCDEF",
    email: "new.member@acme.co",
    role_id: "role_01HXYZROLEAA",
  })
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "member_invite": {
      "id": "meminv_01HXYZINVAA",
      "email": "new.member@acme.co",
      "role_id": "role_01HXYZROLEAA",
      "accepted": false,
      "token": "inv_token_abc123",
      "expires_at": "2026-06-22T09:00:00.000Z",
      "created_at": "2026-06-15T09:00:00.000Z"
    }
  }
  ```
</ResponseExample>