---
title: How to Invite a User to an Organization
url: https://docs.vultr.com/platform/iam/organizations/organization-invitations/how-to-invite-a-user-to-an-organization
description: Invite a new user to join your Vultr organization through IAM. Send an invitation that grants the user access to organizational resources upon acceptance.
publish_date: 2026-03-24T19:51:54.782079Z
last_updated: 2026-06-01T20:23:04.613855Z
---

Inviting a user to an organization sends them an email invitation to join. Once the user accepts the invitation, they become a member of the organization and can access resources based on the roles and policies assigned to them. Invitations expire after 3 days if not accepted.

Follow this guide to invite a user to an organization using the Vultr Console, the Vultr API, or Terraform.

=== "Vultr Console"

    1. Log in to the [Vultr Console](https://console.vultr.com).
    1. Click the organization name in the top navigation bar.
    1. Click **Manage Organization**.
    1. Click the **Users** tab.
    1. Click the **Add User** button.
    1. In the **Add User** panel, select the **Invite Type** as **User**.
    1. Enter the user's **Email Address**.
    1. Click **Review and Invite**.
    1. Review the invitation details and click **Send Invitation**.

        The invitation is sent to the user's email address. The user appears in the **Invitations** section with a status of **Invite Pending** until they accept.

=== "Vultr API"

    1. Send a `POST` request to the [**Create Organization Invite** endpoint](https://www.vultr.com/api/#tag/iam/operation/create-iam-invitation) to send the invitation. Replace `USER-EMAIL` with the email address of the user you want to invite. Set `api_enabled` to `yes` to grant API access to the invited user. The Vultr API key determines the target organization.

        ```console
        $ curl "https://api.vultr.com/v2/invitation" \
            -X POST \
            -H "Authorization: Bearer ${VULTR_API_KEY}" \
            -H "Content-Type: application/json" \
            -d '{
                "email_invited": "USER-EMAIL",
                "permissions": {
                    "api_enabled": "yes"
                }
            }'
        ```

        A successful request returns an HTTP `201 Created` response with an `invite_status` of `Pending`. Note the invitation `id` for tracking or resending.

    1. After the user accepts the invitation, send a `GET` request to the [**Get Organization Invite** endpoint](https://www.vultr.com/api/#tag/iam/operation/get-iam-invitation) to verify acceptance. Replace `{invitation-id}` with the id of the invitation. The `invite_status` changes to `Accepted` and the `date_responded` field shows when the user accepted.

        ```console
        $ curl "https://api.vultr.com/v2/invitation/{invitation-id}" \
            -X GET \
            -H "Authorization: Bearer ${VULTR_API_KEY}"
        ```

        Verify that the `invite_status` field shows `Accepted`.

=== "Terraform"

    1. Ensure the [Vultr Terraform provider](https://registry.terraform.io/providers/vultr/vultr/latest/docs) is configured in your Terraform project.

    1. Define the invitation resource. Replace `USER-EMAIL` with the email address to invite.

        ```hcl
        resource "vultr_organization_invitation" "invite" {
          email       = "USER-EMAIL"
          api_enabled = true
        }
        ```

        Both `email` and `api_enabled` are immutable after creation. Changing either field destroys the existing invitation and sends a new one to the updated address.

    1. Apply the configuration.

        ```console
        $ terraform apply
        ```

        Verify that the output shows `vultr_organization_invitation.invite: Creation complete`. The invitation is sent to the user's email address with a status of `Pending`.