---
title: "Create an employee member portal invitation"
method: POST
path: "/v1/employees/{employee_id}/member_portal_invitations"
tags: ["Member Portal Invitations"]
---

# Create an employee member portal invitation

`POST /v1/employees/{employee_id}/member_portal_invitations`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/employees/{employee_id}/member_portal_invitations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/employees/:employee_id/member_portal_invitations/post.ts> (a function with typed inputs; its response is checked against the schema)

Generates a member portal invitation for the specified employee. If the employee already has an invitation that is not `complete`, calling this endpoint resends it with a new token, and the link from the earlier invitation stops working. A member who already verified must verify again. The `embedded_member_portal_invitation.created` webhook fires again with the new `invitation_url`.

scope: `member_portal_invitation:write`

## Path parameters

- `employee_id` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `201`

Created

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

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