---
title: "Invite a user to a project"
method: POST
path: "/gdc/projects/{project_id}/invitations"
tags: ["invitations"]
---

# Invite a user to a project

`POST /gdc/projects/{project_id}/invitations`

## Request

- Base URL: `https://secure.gooddata.com`
- URL: `https://secure.gooddata.com/gdc/projects/{project_id}/invitations`
- Auth: none declared

## Path parameters

- `project_id` string, required

## Request body

- Invitations
  - `invitations` Invitation[], required
    - `invitation` object, required
      - `meta` MetaRequest
        - `title` string, required: Title of this metadata object. Mustn't contain only whitespace characters
        - `category` string: Category of this metadata object
        - `tags` string: List of tags for this metadata object separated by spaces
        - `author` string, uri: URI of the user's profile
        - `created` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
        - `contributor` string, uri: URI of the user's profile
        - `updated` string: Date and time string in the format `YYYY-MM-DD hh:mm:ss`
        - `identifier` string: Global identifier of a metadata object
        - `flags` string[]: List of flags specified for this metadata object
        - `summary` string, nullable: A short description of this metadata object
        - `projectTemplate` string, uri
        - `uri` string, uri: Link to this metadata object
        - `deprecated` union: Legacy boolean allowing boolean values represented by booleans or numbers
          - '0' | '1'
          - 0 | 1
          - boolean
        - `locked` union: Legacy boolean allowing boolean values represented by booleans or numbers
          - '0' | '1'
          - 0 | 1
          - boolean
        - `unlisted` union: Legacy boolean allowing boolean values represented by booleans or numbers
          - '0' | '1'
          - 0 | 1
          - boolean
        - `isProduction` union: Legacy boolean allowing boolean values represented by booleans or numbers
          - '0' | '1'
          - 0 | 1
          - boolean
        - `sharedWithSomeone` union: Legacy boolean allowing boolean values represented by booleans or numbers
          - '0' | '1'
          - 0 | 1
          - boolean
      - `content` InvitationContent
        - `status` 'ACCEPTED' | 'REFUSED' | 'WAITING' | 'CANCELED'
        - `projectname` string
        - `email` string, email
        - `userFilters` string[]: initial set of userFilter identifiers for invited user
        - `role` string, uri: initial user role in project
        - `firstname` string
        - `lastname` string
        - `phonenumber` string
        - `action` object
          - `setMessage` string: user message
          - `inviteTo` string: invite to an object
      - `links` object
        - `self` string, uri
        - `project` string, uri
        - `profile` string, uri: present only if user is already registred

## Response `200`

_

- CreatedInvitations
  - `createdInvitations` object, required
    - `uri` string[], required
    - `loginsDomainMismatch` string[]: logins whose domain does not match the project domain, no invitation was created for them
    - `loginsAlreadyInProject` string[]: logins already present in the project, no invitation was created for them
    - `uniq` string[]

---

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