---
title: "Send warmed invites (V1 Legacy)"
method: POST
path: "/v1/invites/warmed"
tags: ["Invites"]
---

# Send warmed invites (V1 Legacy)

`POST /v1/invites/warmed`

V1-compatible endpoint to send pre-filled (KYC-primed) invites, in light or full mode.

## Request body

- object
  - `light` boolean — Light mode only requires name+email; defaults to false.
  - `users` object[], required
    - `sumsub_sharetoken` string
    - `role` string — One of 'contractor', 'team_employee', 'aor_contractor'.
    - `details` object, required
      - `email` string, required
      - `firstname` string
      - `lastname` string
      - `middlename` string
      - `dob` string
      - `tin` string
      - `external_reference_id` string
      - `sumsub_id` string
      - `registrationType` string
    - `address` object
      - `country` string
      - `city` string
      - `state` string
      - `address_line1` string
      - `address_line2` string
      - `zip` string
      - `timezone` string
    - `companyData` object
      - `name` string
      - `phone` string
      - `tax_id` string
  - `company_riseid` string — RiseID of the company/team.
  - `company_id` union — Numeric id of the company/team (alternative to company_riseid).
    - string
    - number
  - `role` string — One of 'contractor' (default), 'team_employee', 'aor_contractor'.

## Response `200`

Default Response

- object
  - `data` object, required
    - `failed` object[], required
      - `invite` string, required
      - `error` string, required
    - `countAdded` number, required
    - `invited` string[], required

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy.md) · [All operations](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/riseworks/b2b-api-v1-legacy/revisions/6f6941749255/schema)