Skip to main content
POST
/
meetings
/
schemas
cURL
curl -X POST https://app.mavera.io/api/v1/meetings/schemas \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Discovery Call",
    "description": "Extract key information from sales discovery calls",
    "category": "sales_discovery",
    "fields": [
      {
        "name": "budget_range",
        "label": "Budget Range",
        "field_type": "enum",
        "enum_options": ["<10k", "10k-50k", "50k-100k", ">100k"],
        "is_required": true,
        "requires_evidence": true
      },
      {
        "name": "decision_makers",
        "label": "Decision Makers",
        "field_type": "list",
        "requires_evidence": true
      },
      {
        "name": "timeline",
        "label": "Expected Timeline",
        "field_type": "text",
        "requires_evidence": true
      }
    ]
  }'
{
  "id": "<string>",
  "object": "meeting.schema",
  "name": "<string>",
  "description": "<string>",
  "is_built_in": true,
  "is_published": true,
  "version": 123,
  "workspace_id": "<string>",
  "user_id": "<string>",
  "is_marketplace": true,
  "author_name": "<string>",
  "author_email": "<string>",
  "downloads": 123,
  "average_rating": 123,
  "tags": [
    "<string>"
  ],
  "fields": [
    {
      "id": "<string>",
      "name": "<string>",
      "label": "<string>",
      "is_required": true,
      "requires_evidence": true,
      "enum_options": [
        "<string>"
      ],
      "scoring_enabled": true,
      "scoring_rubric": {},
      "crm_field_mapping": {},
      "order": 123
    }
  ],
  "field_count": 123,
  "usage_count": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json
​
name
string
required

Schema name

Required string length: 1 - 100
​
fields
object[]
required
Required array length: 1 - 50 elements
​
description
string

Schema description

​
category
enum<string>
default:custom

Category of the meeting schema

Available options:
sales_discovery,
qualification,
objection_competitor,
cs_health,
product_feedback,
custom
​
workspace_id
string

Workspace ID (uses default workspace if not specified)

Response

Schema created successfully

​
id
string
​
object
enum<string>
Available options:
meeting.schema
​
name
string
​
description
string | null
​
category
enum<string>

Category of the meeting schema

Available options:
sales_discovery,
qualification,
objection_competitor,
cs_health,
product_feedback,
custom
​
is_built_in
boolean

Whether this is a system-provided schema

​
is_published
boolean

Whether this schema is published to marketplace

​
version
integer
​
workspace_id
string | null
​
user_id
string | null
​
is_marketplace
boolean
​
author_name
string | null
​
author_email
string | null
​
downloads
integer | null
​
average_rating
number | null
​
tags
string[] | null
​
fields
object[]
​
field_count
integer
​
usage_count
integer

Number of times this schema has been used

​
created_at
string<date-time>
​
updated_at
string<date-time>