Description

Invite a user to join a team

Request

HTTP Method: POST

Path Parameter Description
team-id ID of the team
Query Parameter Description
email Email address of the user
user_id optional ID of an existing user in the Tines tenant

user_id or email must be provided but not both.

curl -X POST \
  https://<tenant-name>.tines.io/api/v1/teams/<team-id>/invite_member \
  -H 'content-type: application/json' \
  -H 'x-user-email: <email-address>' \
  -H 'x-user-token: <api-token>'
  -d '{
        "email": "user@example.com",
      }'

Response

A successful request will return a JSON object representing the invited user.

Field description

Parameter Description
id User ID.
email User email.
first_name User first name.
last_name User last name.
is_admin Boolean flag indicating whether user is an admin.
created_at Timestamp describing when the user was created.
last_seen Timestamp describing when the user was last seen in the platform.
invitation_accepted Boolean flag indicating if the user accepted the invitation to join the team

Sample response

{
  "id": 2,
  "first_name": "First name",
  "last_name": "Last name",
  "email": "user@example.com",
  "is_admin": false,
  "created_at": "2021-04-30T09:12:40Z",
  "last_seen": null,
  "invitation_accepted": false
}