Invite a new member

POST/api/member/invite

Creates an inviting user and issues a password-set link. Re-invites refresh the link. no-login members can be created without an email and receive no mail.

Request body

emailstring: Email address to send the invitation to. Required unless role is no-login.
roleadmin | member | no-loginRequired: Role of the new member. admin can manage the space, member is a regular member, and no-login is a member who cannot log in (not billed, no email is sent).
namestring: Username (@name), 3 to 15 characters of letters, digits, ., _ and -. Generated from the email address if omitted.
fullNamestring: Display name, up to 255 characters. Defaults to the part of the email address before the @.
projectIdsinteger[]: IDs of projects to add the member to (up to 100).

Responses

200Invited
400Email already exists
401Authentication is required
403Admin only

Request

curl -X POST "https://<space>.repsona.com/api/member/invite" \
  -H "Authorization: Bearer $REPSONA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "noah.rivera@example.com",
    "role": "member",
    "name": "noah",
    "fullName": "Noah Rivera",
    "projectIds": [
      297
    ]
  }'

Example response

{
  "userId": 1129
}