# Mixmax Developer Documentation

> The Mixmax Developer portal allows you to integrate functionality into the Mixmax platform.

Append .md to any documentation page URL to get its markdown version.

## Guides
- [Documentation](https://developer.mixmax.com/docs.md): Mixmax Developer documentation

## API Reference
- [/calls](https://developer.mixmax.com/reference/listcalls.md): **Limited beta.** The Calls read API is currently gated by an access allowlist; callers without access receive `404` responses. To request access, email [developer@mixmax.com](mailto:developer@mixmax.com).  Lists calls placed with the Mixmax Dialer, newest first. By default you see your own calls; workspace admins can pass `scope=workspace` to list calls for every member of their workspace (for example, to feed a conversation-intelligence integration).  Only calls that were actually dialed are returned. Recording audio is not included — use `GET /calls/{id}/recording` with the returned `_id` (recording playback requires the Dialer `calling` feature on your workspace).
- [/calls/:id/recording](https://developer.mixmax.com/reference/getcallrecording.md): **Limited beta.** The Calls read API is currently gated by an access allowlist; callers without access receive `404` responses. To request access, email [developer@mixmax.com](mailto:developer@mixmax.com).  Streams a completed call's recording as MP3 audio. Requires the Dialer `calling` feature on your workspace. Mixmax authenticates to the telephony provider and streams the bytes back; there is no durable, shareable media URL.  `Range` requests are honored so audio players can seek (such responses are `206 Partial Content`). Responses are private to the caller and must not be cached.  This endpoint has its own rate limit of 20 requests per minute per user, in addition to the API-wide limit.
- [/contactgroups [deprecated]](https://developer.mixmax.com/reference/contactgroups-2.md): Contact groups that you have access to (either that you have created, or that have been shared with you)
- [/contactgroups/:id [deprecated]](https://developer.mixmax.com/reference/contactgroupsid-1-1.md): Edit a Contact Group
- [/contactgroups/:id/contacts/:contactId [deprecated]](https://developer.mixmax.com/reference/contactgroupsidcontactscontactid-1.md): Remove a Contact from a Contact Group
- [/filerequests](https://developer.mixmax.com/reference/filerequests-1.md): Returns File Requests that you've sent out
- [/meetings/summaries/search](https://developer.mixmax.com/reference/meetingssummariessearch.md): Search and retrieve meeting summaries with optional filters. Returns summaries for meetings where the authenticated user is the owner, or if workspace-wide access is enabled via admin settings, summaries for all workspace members.  **Required Feature:** `mixmaxApi` (API access must be enabled for your workspace)  **Workspace Access:** If "Allow workspace-wide transcript access via API" is enabled in Admin Settings > Meeting Copilot, users can access summaries from all workspace members' meetings.
- [/meetings/transcripts/:id](https://developer.mixmax.com/reference/meetingstranscriptsid.md): Retrieve the full transcript for a specific meeting by its summary ID. Returns the complete transcript with speaker identification and timestamps.  **Required Feature:** `mixmaxApi` (API access must be enabled for your workspace)  **Workspace Access:** If "Allow workspace-wide transcript access via API" is enabled in Admin Settings > Meeting Copilot, users can access transcripts from all workspace members' meetings.  **Note:** The `id` parameter is the meeting summary ID (the `_id` field from the `/meetings/summaries/search` response).
- [/messages/:id](https://developer.mixmax.com/reference/messagesid-2.md): Retrieves a message by id
- [/messages/:id](https://developer.mixmax.com/reference/messagesid-1-1.md): Updates a message
- [/messages/:id/send](https://developer.mixmax.com/reference/messagesidsend-copy.md): Sends a message
- [/reports/data/table](https://developer.mixmax.com/reference/reportsdatatable.md): Queries messages and meetings. If you're looking to query for any analytics in Mixmax, this is likely the API you want.
- [/rules (webhooks)](https://developer.mixmax.com/reference/rules-2.md): Mixmax rules are a way to intercept events and route them to a webhook or some other place https://app.mixmax.com/dashboard/rules. Also see https://engineering.mixmax.com/blog/introducing-rules for how they can be used.
- [/sequences](https://developer.mixmax.com/reference/sequences-1.md): Returns a list of sequences that you have access to
- [/snippets (aka Templates)](https://developer.mixmax.com/reference/snippets-1.md): Lists templates or snippets that you have access to (including those shared with you)
- [/snippettags/:id](https://developer.mixmax.com/reference/snippettags-id-delete-1.md): Deletes a snippet tag
- [/teams](https://developer.mixmax.com/reference/teams-post-1.md): Creates a team.
- [/calls/:id/transcript](https://developer.mixmax.com/reference/getcalltranscript.md): **Limited beta.** The Calls read API is currently gated by an access allowlist; callers without access receive `404` responses. To request access, email [developer@mixmax.com](mailto:developer@mixmax.com).  Returns the transcript of a completed call. Requires the Dialer `calling` feature on your workspace, and transcription must be enabled for the workspace. By default you read your own calls; workspace admins can pass `scope=workspace` to read any member's.  When transcription is complete, `turns` holds the normalized, time-ordered speaker turns. While it is still in progress or if it failed, `turns` is empty and `status` reflects the state. Responses are private to the caller and must not be cached.