---
title: "Send invitation emails"
method: POST
path: "/api/v2/user_invitations"
tags: ["Users"]
---

# Send invitation emails

`POST /api/v2/user_invitations`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/user_invitations`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `user_access_invite`

Sends emails to one or more users inviting them to join the organization.

## Request body

- UserInvitationsRequest: Object to invite users to join the organization.
  - `data` UserInvitationData[], required: List of user invitations.
    - `relationships` UserInvitationRelationships, required: Relationships data for user invitation.
      - `user` RelationshipToUser, required: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
    - `type` 'user_invitations', required: User invitations type.

## Response `201`

OK

- UserInvitationsResponse: User invitations as returned by the API.
  - `data` UserInvitationResponseData[]: Array of user invitations.
    - `attributes` UserInvitationDataAttributes: Attributes of a user invitation.
      - `created_at` string, date-time: Creation time of the user invitation.
      - `expires_at` string, date-time: Time of invitation expiration.
      - `invite_type` string: Type of invitation.
      - `uuid` string: UUID of the user invitation.
    - `id` string: ID of the user invitation.
    - `relationships` UserInvitationRelationships: Relationships data for user invitation.
      - `user` RelationshipToUser, required: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
    - `type` 'user_invitations': User invitations type.

## Other responses

- `400`: Bad Request
- `403`: Authentication error
- `429`: Too many requests

---

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