Channel of Choice API

The Channel of Choice API provides a channel-agnostic, client-grade interface to the manager-persona approvals and upcoming events. It allows client organizations to integrate Magnit VMS approvals into their preferred channel (Microsoft Teams, Slack, an internal portal, mobile app, and so on) without users having to log into the VMS web app for every action.

What it covers

Approvals — list, view detail, and take action on:
- Requisition approvals — headcount, extension, financial.
- Billing items — time, expense, adjustment, project.
Upcoming events — view interview and engagement events; cancel an interview when needed.
Deep links into VMS — every API response carries deep links back to the VMS approval, billing detail, engagement, interview detail, and reschedule-interview views, so users can hand off into the full VMS UI for any action that is not yet supported in their channel.

Authentication

The Channel of Choice API uses the same user-level API key as the VMS API. Generate or retrieve a key from your User Profile; see Set Up a User API Key. Select the Channel of Choice scope when generating the key.

Documentation

For endpoint reference, payloads, and rate limits, see Channel of Choice Endpoints. The OpenAPI / Swagger specification and the Getting Started Guide are published separately and are linked from there.

Note:

All actions performed via the API are logged in the same approval-history audit trail as actions taken in the web app, so reviewers see a complete history regardless of channel.