Organization Team Members Api Service

Add a new team member to an organization. Reuses an existing Metricool account for the given email when one already exists, or creates a new shell account for it, then sends an invitation email. Only the organization owner or a delegated team member with the manageTeamMembers permission may call this.

post/v2/organizations/{organizationId}/team-members

Request

  • Base URL: https://app.metricool.com/api
  • URL: https://app.metricool.com/api/v2/organizations/{organizationId}/team-members
  • Auth: none declared

Path parameters

organizationIdinteger required

Id of the organization

Request body

emailstring required

Email of the user to invite as a team member.

roleIdinteger required

Id of the role to assign to the new team member. Must belong to the organization owner.

Example request

{
  "email": "member@example.com",
  "roleId": 10
}

Response

Team member added.

metadataobject

Example response

{
  "data": {
    "id": 42,
    "userId": 1234,
    "email": "member@example.com",
    "fullName": "Ana García",
    "profilePicture": "https://cdn.metricool.com/avatars/1234.png",
    "roleId": 10,
    "enabled": true
  }
}

Changes

No recorded changes to this operation across all 4 revisions of this API.