{
  "info": {
    "name": "Avoma — mcp.ai",
    "description": "REST API for the Avoma MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/avoma",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "avoma_create_call",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/call",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "call"
          ]
        },
        "description": "Submit an externally hosted call recording to Avoma for asynchronous processing. This persistently creates external call state, and Avoma will download the recording from the supplied publicly reachab",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"end_at\": \"\",\n  \"source\": \"\",\n  \"to_name\": \"\",\n  \"answered\": false,\n  \"start_at\": \"\",\n  \"direction\": \"\",\n  \"from_name\": \"\",\n  \"to_number\": \"\",\n  \"user_email\": \"\",\n  \"external_id\": \"\",\n  \"from_number\": \"\",\n  \"is_voicemail\": false,\n  \"participants\": \"\",\n  \"recording_url\": \"\",\n  \"crm_associations\": \"\",\n  \"additional_details\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_get_call",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/call",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "call"
          ]
        },
        "description": "Retrieve one externally ingested Avoma call by the dialer system's external ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"external_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_get_engagement_summary",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/engagement/summary",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "engagement",
            "summary"
          ]
        },
        "description": "Aggregate Avoma engagement metrics across visible users for a required UTC date range and optional meeting and user filters.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"is_call\": false,\n  \"to_date\": \"\",\n  \"from_date\": \"\",\n  \"is_internal\": false,\n  \"user_emails\": \"\",\n  \"is_impromptu\": false,\n  \"meeting_type_uuids\": \"\",\n  \"shared_meetings_only\": false,\n  \"meeting_outcome_uuids\": \"\",\n  \"recording_duration_gte\": 0,\n  \"recording_duration_lte\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_get_meeting",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/meeting",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "meeting"
          ]
        },
        "description": "Retrieve one meeting by UUID, including processing/readiness state and optionally CRM associations.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"meeting_uuid\": \"\",\n  \"include_crm_associations\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_get_meeting_analysis",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/meeting/analysis",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "meeting",
            "analysis"
          ]
        },
        "description": "Return Avoma's AI insights, topical and speaker segments, and sentiment records for one processed meeting in a single read-only invocation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"meeting_uuid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_get_recording",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/recording",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "recording"
          ]
        },
        "description": "Get time-limited audio and video URLs for a meeting recording.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"meeting_uuid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_calls",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/calls",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "calls"
          ]
        },
        "description": "List externally ingested calls in a required UTC date range, optionally filtered by inbound or outbound direction. Returns one page and a cursor.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"to_date\": \"\",\n  \"direction\": \"\",\n  \"from_date\": \"\",\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_configuration_resources",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/configuration/resources",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "configuration",
            "resources"
          ]
        },
        "description": "List one Avoma configuration catalog: custom categories, smart categories, scorecards, templates, meeting types, or meeting outcomes.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order\": \"\",\n  \"page_size\": 0,\n  \"next_cursor\": \"\",\n  \"resource_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_engagement_metrics",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/engagement/metrics",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "engagement",
            "metrics"
          ]
        },
        "description": "List per-user Avoma engagement metrics over a required UTC date range with meeting and user filters. Returns one page and an opaque cursor.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order\": \"\",\n  \"is_call\": false,\n  \"to_date\": \"\",\n  \"from_date\": \"\",\n  \"page_size\": 0,\n  \"is_internal\": false,\n  \"next_cursor\": \"\",\n  \"user_emails\": \"\",\n  \"is_impromptu\": false,\n  \"meeting_type_uuids\": \"\",\n  \"shared_meetings_only\": false,\n  \"meeting_outcome_uuids\": \"\",\n  \"recording_duration_gte\": 0,\n  \"recording_duration_lte\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_meetings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/meetings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "meetings"
          ]
        },
        "description": "Find meetings visible to the connected Avoma user within a required UTC date range, with optional attendee, CRM, call-type, privacy-context, duration, and ordering filters. Returns one page and an opa",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order\": \"\",\n  \"is_call\": false,\n  \"to_date\": \"\",\n  \"from_date\": \"\",\n  \"page_size\": 0,\n  \"is_internal\": false,\n  \"next_cursor\": \"\",\n  \"crm_lead_ids\": \"\",\n  \"attendee_emails\": \"\",\n  \"crm_account_ids\": \"\",\n  \"crm_contact_ids\": \"\",\n  \"crm_opportunity_ids\": \"\",\n  \"recording_duration_gte\": 0,\n  \"include_crm_associations\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_notes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/notes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "notes"
          ]
        },
        "description": "Retrieve Avoma notes for meetings in a required UTC date range, optionally narrowed to a meeting or custom category and rendered as JSON, HTML, or Markdown.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order\": \"\",\n  \"to_date\": \"\",\n  \"from_date\": \"\",\n  \"page_size\": 0,\n  \"next_cursor\": \"\",\n  \"meeting_uuid\": \"\",\n  \"output_format\": \"\",\n  \"custom_category_uuid\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_scorecard_evaluations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/scorecard/evaluations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "scorecard",
            "evaluations"
          ]
        },
        "description": "List Avoma scorecard evaluations, optionally filtered by UTC date range, scorecard templates, meeting, or evaluated users. Returns one page at a time.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"to_date\": \"\",\n  \"from_date\": \"\",\n  \"page_size\": 0,\n  \"next_cursor\": \"\",\n  \"user_emails\": \"\",\n  \"meeting_uuid\": \"\",\n  \"scorecard_uuids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_snippets",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/snippets",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "snippets"
          ]
        },
        "description": "Find user-created or AI-generated meeting snippets by meeting UUID or by a UTC date range of at most 180 days. Returns one page at a time.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"to_date\": \"\",\n  \"from_date\": \"\",\n  \"page_size\": 0,\n  \"next_cursor\": \"\",\n  \"meeting_uuid\": \"\",\n  \"is_ai_generated\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_transcriptions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/transcriptions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "transcriptions"
          ]
        },
        "description": "Find full meeting transcriptions by meeting UUID or by a UTC date range, with attendee and CRM filters. Returns one page because transcript payloads can be large.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"to_date\": \"\",\n  \"from_date\": \"\",\n  \"page_size\": 0,\n  \"next_cursor\": \"\",\n  \"crm_lead_ids\": \"\",\n  \"meeting_uuid\": \"\",\n  \"attendee_emails\": \"\",\n  \"crm_account_ids\": \"\",\n  \"crm_contact_ids\": \"\",\n  \"crm_opportunity_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_users",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "users"
          ]
        },
        "description": "Return users visible in the Avoma organization, including their UUID, email, role, teams, and active status.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "avoma_list_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "webhooks"
          ]
        },
        "description": "Audit the connected organization's active Avoma webhook subscriptions without reading signing secrets.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}