Invite a user to the organization

Required scopes:

• organizations:write

Invite a user to the organization. To automatically add the user to teams, specify IDs of the teams. The user gets the team role member. You can change the user team role with the API call POST /users/{userId}/user-team-roles/{teamId}.

POSThttps://eu1.make.com/api/v2/organizations/{organizationId}/invite

Authorization

token

Path parameters

organizationId*integer

The ID of the organization.

Example: 11

Body

application/json

usersRoleIdinteger

The ID of the user organization role assigned to the invited user. Get list of user role IDs from the API call GET /users/roles.

email*string (email)

The user registration email.

name*string

The user name visible in the team and organization interface.

notestring

Note added to the invitation.

teamsIdarray of integer

The list of team IDs to which the invited user will be assigned. The invited user will receive the team role member.

Response

200

Successful response

Body

application/json

userobject

userOrganizationRoleobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://eu1.make.com/api/v2/organizations/{organizationId}/invite', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "usersRoleId": 12,
      "email": "[e-mail]",
      "name": "Tom",
      "note": "Hi Tom, please join our organization.",
      "teamsId": [
        5,
        26
      ]
    }),
});
const data = await response.json();

Response

200

{
  "user": {
    "id": 0,
    "name": "text",
    "email": "[e-mail]",
    "language": "text",
    "timezoneId": 0,
    "localeId": 0,
    "countryId": 0,
    "features": {
      "allow_apps": false
    },
    "avatar": "https://example.com"
  },
  "userOrganizationRole": {
    "userId": 0,
    "organizationId": 0,
    "usersRoleId": 0,
    "invitation": "text"
  }
}