> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supersonic.cv/llms.txt
> Use this file to discover all available pages before exploring further.

# reports.create



## OpenAPI

````yaml POST /reports/create
openapi: 3.1.0
info:
  title: Supersonic CRM API
  description: 62 tools for managing your CRM data. Call via CLI, REST, or MCP.
  version: 1.0.0
servers:
  - url: https://api.supersonic.cv
    description: Production
security:
  - bearerAuth: []
paths:
  /reports/create:
    post:
      tags:
        - reports
      summary: Create a new saved report with name and config
      operationId: reports.create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Report name
                config:
                  type: object
                  description: >-
                    Report config: {object_type, metric, metric_field, group_by,
                    time_bucket, chart_type, filters}
                  properties:
                    object_type:
                      type: string
                      description: ObjectType slug
                    metric:
                      type: string
                      enum:
                        - count
                        - sum
                        - avg
                        - min
                        - max
                    metric_field:
                      type: string
                      description: 'Field slug to aggregate (default: ''*'')'
                    group_by:
                      type: string
                      description: Field slug to group by
                    time_bucket:
                      type: string
                      enum:
                        - day
                        - week
                        - month
                        - quarter
                        - year
                    chart_type:
                      type: string
                      enum:
                        - bar
                        - stacked_bar
                        - line
                        - area
                        - pie
                        - donut
                        - funnel
                        - number
                        - table
                    filters:
                      type: array
                      items:
                        type: object
                        properties:
                          field:
                            type: string
                          operator:
                            type: string
                          value: {}
                  required:
                    - object_type
                    - metric
                    - chart_type
              required:
                - name
                - config
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Validation error
        '403':
          description: Permission denied
        '429':
          description: Rate limit exceeded
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key: supersonic_live_...'

````