---
title: "Create Invitation"
method: POST
path: "/invitations"
tags: ["Invitations"]
---

# Create Invitation

`POST /invitations`

Create an invitation into the current account.

<b>Scopes:</b> amReadWriteInvitation

## Query parameters

- `email` string, required — Create an invitation for current email
- `firstName` string — First name of invited user
- `lastName` string — Last name of invited user
- `role` 'User' | 'Collaborator' — * `User` * `Collaborator`
- `external` boolean — [Deprecated] It is recommended to use 'userTypeId' parameter instead. Set external flag for invited user. Flag 'External' can be applied only to the role 'User'. Mutually exclusive with userTypeId param
- `subject` string — Custom message subject. Not available for free accounts
- `message` string — Custom message body. Not available for free accounts
- `userTypeId` string — Set user type in account. Mutually exclusive with role and external params

## Response `2XX`

success response

- object
  - `data` Invitation[]
    - `userTypeId` string — Invited User Type ID
    - `accountId` string
    - `firstName` string — First Name
    - `lastName` string — LastName
    - `external` boolean — Is user external
    - `inviterUserId` string
    - `role` 'User' | 'Collaborator' — * `User` * `Collaborator`
    - `id` string
    - `email` string — Email
    - `status` 'Declined' | 'Cancelled' | 'Pending' | 'Accepted' — * `Declined` * `Cancelled` * `Pending` * `Accepted`
    - `invitationDate` string — Date when invitation was created<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
    - `resolvedDate` string — Date when the invitation was resolved<br>Format: yyyy-MM-dd'T'HH:mm:ss'Z'
  - `kind` 'accounts' | 'users' | 'contacts' | 'assets' | 'eDiscoveryReport' | 'folders' | 'folderTree' | 'tasks' | 'taskIds' | 'timelogs' | 'timelogCategories' | 'timelogLockPeriods' | 'timetrackerTimers' | 'comments' | 'attachments' | 'url' | 'version' | 'dataExport' | 'dataExportSchema' | 'auditLog' | 'accessRoles' | 'stream' | 'changes' | 'posts' | 'mailSettings' | 'integrationInfo' | 'gmailIntegrationSettings' | 'workTypesForIntegrations' | 'ids' | 'backups' | 'domains' | 'dependencies' | 'workflows' | 'workschedules' | 'workscheduleExclusions' | 'workscheduleUserExclusions' | 'customfields' | 'customfieldIds' | 'customstatuses' | 'invitations' | 'notifications' | 'jobroles' | 'placeholders' | 'groups' | 'session' | 'dashboards' | 'widgets' | 'taskCreationSettings' | 'colors' | 'experiments' | 'topics' | 'topicComments' | 'webhooks' | 'reviews' | 'boards' | 'textSearch' | 'chatChannels' | 'chatMessages' | 'forms' | 'requestForms' | 'request' | 'report' | 'platformWidgets' | 'platformWidgetInstances' | 'spaces' | 'pdf' | 'customerSatisfaction' | 'asyncJob' | 'approvals' | 'highlights' | 'highlightsList' | 'highlightsSettings' | 'highlightsCard' | 'timesheet' | 'timesheetRow' | 'timesheetSubmissionRule' | 'mobileFeatures' | 'mobileSettings' | 'folderBlueprintTree' | 'taskBlueprintTree' | 'feedback' | 'timeline_snapshot' | 'contactIds' | 'bookings' | 'integrateThreshold' | 'hourlyRatesProvision' | 'hourlyRates' | 'projectTeamMembers' | 'contactsHistory' | 'tasksHistory' | 'foldersHistory' | 'activityDigest' | 'workItemTemplates' | 'workTemplates' | 'workItemMetadata' | 'workItem' | 'customItemTypes' | 'verificationCode' | 'views' | 'listView' | 'tableView' | 'userTypes' | 'reactions' | 'externalRequesters' | 'workscheduleCapacityOverrides' | 'userCapacityOverrides' | 'userCapacityExclusions' | 'rollups' | 'requestFormPrefill' | 'userAggregatedCapacity' | 'cascadingFieldSettings'

## Other responses

- `4XX` — client-side error response
- `5XX` — server-side error response

---

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