---
title: "Create Invite"
method: POST
path: "/invites"
tags: ["Invites"]
---

# Create Invite

`POST /invites`

Create and send an invite to a user

## Request body

- InvitePostRequest
  - `fullName` string, required — The full name of the person to be invited
  - `firstName` string — The first name of the person to be invited
  - `lastName` string — The last name of the person to be invited
  - `email` string, email, required — Email of the person to be invited
  - `templateId` string, required — The template ID to be used in the invite
  - `winkTemplateId` string — The Wink template ID used in the invitation

## Response `201`

OK

- InvitePostResponse
  - `code` 'OK' | 'CREATED' | 'INVALID_CREDENTIALS' | 'INVALID_PARAMETERS' | 'INVALID_TOKEN' | 'UNAUTHORIZED_ACCESS' | 'MISSING_RESOURCE' | 'REQUEST_LIMIT_EXCEEDED' | 'SERVER_ERROR' | 'UNSUPPORTED_METHOD' | 'SERVER_UNAVAILABLE' | 'TIME_LIMIT_EXCEEDED' — Request status code
  - `message` string — Message response to the request
  - `requestId` string — Unique ID that is added to the body of every response for easy traceability of the request in our logs.
  - `data` Invite — Invitation for a user to share their data.
    - `id` string, required — Unique ID of this object
    - `createdAt` string, date-time, required — Date and time
    - `fullName` string, required — The full name of the invited user
    - `firstName` string — The first name of the invited user
    - `lastName` string — The last name of the invited user
    - `email` string, email, required — The email address of the invited user
    - `templateId` string, required — The template ID used in the invitation
    - `winkTemplateId` string — The Wink template ID used in the invitation
    - `userId` string, required — The user ID for this invitation
    - `status` 'INVITED' | 'EMAIL_OPENED' | 'LANDING_PAGE_OPENED' | 'WINK_WIDGET_OPENED' | 'LINKED' | 'REVOKED', required — Status of the invite
    - `updatedAt` string, date-time, required — Date and time
    - `invitedAt` string, date-time, required — Date and time
    - `linkedAt` string, date-time, required — Date and time
    - `inviteLandingPageUrl` string — URL of the unique landing page for the invited user to connect their accounts

---

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