Skip to main content

Miro Admin

Miro Admin lists Enterprise organization members (email, role, license, and active status) and can remove a member from a team.

This is a dedicated Enterprise org connector. Miro's public REST APIs for organization members require an Enterprise plan and a Company Admin.

Removing a team member does not change the organization license. The documented write path is DELETE /v2/orgs/{org_id}/teams/{team_id}/members/{member_id}. That takes the person off that team only. Org-level license downgrade is not available through this API.

Authentication Types​

Miro Admin supports 1 authentication method:

  • OAuth — Register your own Miro app. The connecting user must be a Company Admin.
    • Pros: Refresh tokens, per-admin audit trail
    • Cons: Enterprise plan; app must request organization scopes and be installed on the org

Configuration​

FieldExample
Miro Organization ID3074457345821141000

The id appears in the company admin URL.

Setting up OAuth​

  1. Confirm the org is on a Miro Enterprise plan and that you are a Company Admin.
  2. Create an app at miro.com/app/settings/user-profile/apps or in the Miro Developer Platform.
  3. Add the Willow redirect URI under Redirect URI for OAuth2.0.
  4. Select organizations:read, organizations:teams:read, and organizations:teams:write.
  5. Install the app on the Enterprise organization, then paste the Client ID and Client secret into Willow.
  6. Enter the Organization ID.

Token exchange uses POST https://api.miro.com/v1/oauth/token (application/x-www-form-urlencoded).

If Enterprise APIs return 403, Miro may still need to enable org APIs for the app. See Get organization members.

Available Tools​

  • List Members — GET /v2/orgs/{org_id}/members. Filter by emails (max 10), role, license, and active. Page with cursor and limit (max 100). Returns email, active, license, and role.
  • Get Member — GET /v2/orgs/{org_id}/members/{member_id}.
  • List Teams — GET /v2/orgs/{org_id}/teams. Use the team id with Remove Team Member.
  • Remove Team Member — DELETE /v2/orgs/{org_id}/teams/{team_id}/members/{member_id}. Removes the member from that team only. Does not deactivate the org account or change the org license.

Troubleshooting​

403 on list members​

Cause: The app is missing organizations:read, the installer is not a Company Admin, or the org is not Enterprise.

Solution: Reinstall as a Company Admin with the org scopes above. Confirm the plan.

Member still has a paid license after remove​

Cause: Team removal is not an organization unlicense.

Solution: Change or reclaim the license in the Miro company admin UI. This connector cannot set license on the organization member.

On this page