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

# Creating a New MOMT Report

> This endpoint creates a new MOMT Report.

## Request URL

```http theme={null}
POST https://app.tatango.com/api/v2/momt_reports
```


## OpenAPI

````yaml POST /api/v2/momt_reports
openapi: 3.1.0
info:
  title: momoGood Messaging API v2
  description: >-
    The platform management API for momoGood Messaging (formerly the Tatango v2
    API). Manage lists, subscribers, custom fields, tags, webhooks, shortcodes,
    MOMT reports, and scheduled broadcasts from a single REST surface.
  version: 2.0.0
servers:
  - url: https://app.tatango.com
security:
  - basicAuth: []
paths:
  /api/v2/momt_reports:
    post:
      tags:
        - Message Log (MOMT) Reports
      summary: Creating a New MOMT Report
      description: This endpoint creates a new MOMT Report.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                date_from:
                  type: string
                  format: date-time
                  description: Start date for the MOMT report
                date_to:
                  type: string
                  format: date-time
                  description: End date for the MOMT report
                webhook_callback_url:
                  type: string
                  format: uri
                  description: Webhook callback URL for report completion notification
              required:
                - date_from
                - date_to
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateMomtReportResponse'
              example:
                status: OK
                momt_report:
                  id: 3
                  account_id: 22
                  s3_url: null
                  import_started_at: null
                  import_completed_at: null
                  total_rows: null
                  processed_rows: 0
                  percent_complete: 0
                  mo_count: 0
                  mt_count: 0
                  shortcode: null
                  date_range: json
                  date_from: '2016-08-08T22:10:41+01:00'
                  date_to: '2016-09-07T22:10:41+01:00'
                  campaign: null
                  carrier: null
                  phone_number: null
                  direction: null
                  status_array: null
                  created_at: '2016-09-07T14:10:41-07:00'
                  updated_at: '2016-09-07T14:10:41-07:00'
                  counts_calculated: false
                  type: null
                  is_csv: false
                  webhook_callback_url: null
                  run_errors: null
                  message_type: null
                  cancelled: null
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: |-
            curl "https://app.tatango.com/api/v2/momt_reports" -X POST \
              -H "Accept: application/json" \
              -H "Content-Type: application/json" \
              -u emailaddress@mydomain.com:my_api_key \
              -d '{"date_from":"2016-08-08T22:10:41+01:00","date_to":"2016-09-07T22:10:41+01:00","webhook_callback_url":null}'
        - lang: Ruby
          label: Ruby
          source: |-
            require 'net/http'
            require 'uri'
            require 'json'

            uri = URI.parse('https://app.tatango.com/api/v2/momt_reports')
            http = Net::HTTP.new(uri.host, uri.port)
            request = Net::HTTP::Post.new(uri.request_uri)
            request.basic_auth("emailaddress@mydomain.com", "my_api_key")
            request['Content-Type'] = 'application/json'
            request.body = JSON.generate({
              date_from: '2016-08-08T22:10:41+01:00',
              date_to: '2016-09-07T22:10:41+01:00',
              webhook_callback_url: nil
            })
            response = http.request(request)
        - lang: JavaScript
          label: JavaScript
          source: >-
            var request = new XMLHttpRequest();

            request.open('POST', 'https://app.tatango.com/api/v2/momt_reports',
            false);

            request.setRequestHeader('Content-Type', 'application/json');

            request.setRequestHeader('Authorization', 'Basic ' +
            btoa('emailaddress@mydomain.com:my_api_key'));

            var data = JSON.stringify({
              date_from: '2016-08-08T22:10:41+01:00',
              date_to: '2016-09-07T22:10:41+01:00',
              webhook_callback_url: null
            });

            request.send(data);
components:
  schemas:
    CreateMomtReportResponse:
      type: object
      properties:
        status:
          type: string
          example: OK
        momt_report:
          type: object
          properties:
            id:
              type: integer
              example: 3
            account_id:
              type: integer
              example: 22
            s3_url:
              type:
                - string
                - 'null'
            import_started_at:
              type:
                - string
                - 'null'
            import_completed_at:
              type:
                - string
                - 'null'
            total_rows:
              type:
                - integer
                - 'null'
            processed_rows:
              type: integer
              example: 0
            percent_complete:
              type: integer
              example: 0
            mo_count:
              type: integer
              example: 0
            mt_count:
              type: integer
              example: 0
            shortcode:
              type:
                - string
                - 'null'
            date_range:
              type: string
              example: json
            date_from:
              type: string
              format: date-time
              example: '2016-08-08T22:10:41+01:00'
            date_to:
              type: string
              format: date-time
              example: '2016-09-07T22:10:41+01:00'
            campaign:
              type:
                - string
                - 'null'
            carrier:
              type:
                - string
                - 'null'
            phone_number:
              type:
                - string
                - 'null'
            direction:
              type:
                - string
                - 'null'
            status_array:
              type:
                - array
                - 'null'
            created_at:
              type: string
              format: date-time
              example: '2016-09-07T14:10:41-07:00'
            updated_at:
              type: string
              format: date-time
              example: '2016-09-07T14:10:41-07:00'
            counts_calculated:
              type: boolean
              example: false
            type:
              type:
                - string
                - 'null'
            is_csv:
              type: boolean
              example: false
            webhook_callback_url:
              type:
                - string
                - 'null'
            run_errors:
              type:
                - string
                - 'null'
            message_type:
              type:
                - string
                - 'null'
            cancelled:
              type:
                - string
                - 'null'
          required:
            - id
            - account_id
            - processed_rows
            - percent_complete
            - mo_count
            - mt_count
            - date_range
            - date_from
            - date_to
            - created_at
            - updated_at
            - counts_calculated
            - is_csv
      required:
        - status
        - momt_report
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        The momoGood Messaging API v2 authenticates requests by validating an
        API key passed via HTTP Basic Authentication. Use your login email as
        the username and your API key as the password.

````