---
title: "Send multiple clan invitations"
method: POST
path: "/v1/clans/{clanId}/invites/batch"
tags: ["clans"]
---

# Send multiple clan invitations

`POST /v1/clans/{clanId}/invites/batch`

## Request

- Base URL: `https://app.legend.trade/api/rest`
- URL: `https://app.legend.trade/api/rest/v1/clans/{clanId}/invites/batch`
- Auth: HTTP bearer

Process at most 50 items in input order. Each item has an independent outcome. Retry only failed or unknown items.

## Path parameters

- `clanId` string, uuid, required

## Request body

- object
  - `invitations` ClanSendInvitesItem[], required
    - `targetUserId` string, uuid, required
    - `operationId` string, uuid, required: Keep this ID and input on an unknown-outcome retry. Use a new ID after a terminal rejection.

## Response `200`

Successful response

- ClanSendInvitesOutput
  - `results` ClanSendInvitesResult[], required
    - union
      - object
        - `targetUserId` string, uuid, required
        - `operationId` string, uuid, required
        - `success` true, required
        - `message` string, required
      - object
        - `targetUserId` string, uuid, required
        - `operationId` string, uuid, required
        - `success` false, required
        - `error` ClanSendInvitesBatchError, required
          - `code` 'PARSE_ERROR' | 'BAD_REQUEST' | 'INTERNAL_SERVER_ERROR' | 'NOT_IMPLEMENTED' | 'BAD_GATEWAY' | 'SERVICE_UNAVAILABLE' | 'GATEWAY_TIMEOUT' | 'UNAUTHORIZED' | 'PAYMENT_REQUIRED' | 'FORBIDDEN' | 'NOT_FOUND' | 'METHOD_NOT_SUPPORTED' | 'TIMEOUT' | 'CONFLICT' | 'PRECONDITION_FAILED' | 'PAYLOAD_TOO_LARGE' | 'UNSUPPORTED_MEDIA_TYPE' | 'UNPROCESSABLE_CONTENT' | 'PRECONDITION_REQUIRED' | 'TOO_MANY_REQUESTS' | 'CLIENT_CLOSED_REQUEST', required
          - `message` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

## Changes

- **2026-10-20** `dafcd00312dc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/clans/:clanId/invites/batch/post.md)

---

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