---
title: "Send invitation to new user"
method: POST
path: "/invitations"
tags: ["Users"]
---

# Send invitation to new user

`POST /invitations`

Create and send an invitation for a new user to join your organization.

## Request body

- UserInvitationsSerializer
  - `id` integer
  - `invitee_email` string, required
  - `invitation_token` string
  - `expires_at` string, date-time — Timestamp when the invitation will expire.
  - `organization` integer
  - `created_at` string, date-time — Timestamp when the invitation was created.
  - `invited_by` UserContact
    - `id` integer
    - `first_name` string — User first name.
    - `last_name` string — User last name.
    - `email` string, email — User email address. Unique identifier.
    - `mobile` string, nullable — User cell phone number.
  - `existing_user` string
  - `organization_does_not_exist` boolean
  - `invitation_unique_key` string

## Response `201`

Created

- UserInvitationsSerializer
  - `id` integer
  - `invitee_email` string, required
  - `invitation_token` string
  - `expires_at` string, date-time — Timestamp when the invitation will expire.
  - `organization` integer
  - `created_at` string, date-time — Timestamp when the invitation was created.
  - `invited_by` UserContact
    - `id` integer
    - `first_name` string — User first name.
    - `last_name` string — User last name.
    - `email` string, email — User email address. Unique identifier.
    - `mobile` string, nullable — User cell phone number.
  - `existing_user` string
  - `organization_does_not_exist` boolean
  - `invitation_unique_key` string

---

[API](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api.md) · [All operations](https://skmtc.dev/crisiscleanup/apis/crisiscleanup-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crisiscleanup/crisiscleanup-api/revisions/3fa73d4b2895/schema)