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

# Upload media for an MMS message

> Uploads and validates one media attachment, returning the metadata needed to include the asset in a subsequent Leadping MMS send.



## OpenAPI

````yaml /openapi.json post /sms/media
openapi: 3.1.1
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    organization settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Feedback
  - name: Leads
  - name: LeadStatusChanges
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: Organizations
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /sms/media:
    post:
      tags:
        - Sms
      summary: Upload media for an MMS message
      description: >-
        Uploads and validates one media attachment, returning the metadata
        needed to include the asset in a subsequent Leadping MMS send.
      operationId: Sms_UploadMedia
      requestBody:
        description: A token to cancel the upload.
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ContentType:
                  type: string
                ContentDisposition:
                  type: string
                Headers:
                  type: object
                  additionalProperties:
                    type: array
                    items:
                      type: string
                Length:
                  pattern: ^-?(?:0|[1-9]\d*)$
                  type:
                    - integer
                    - string
                  format: int64
                Name:
                  type: string
                FileName:
                  type: string
        required: true
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                allOf:
                  - $ref: '#/components/schemas/MessageMediaAttachment'
                description: Media attached to an SMS/MMS conversation event.
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/MessageMediaAttachment'
                description: Media attached to an SMS/MMS conversation event.
            text/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/MessageMediaAttachment'
                description: Media attached to an SMS/MMS conversation event.
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                description: >-
                  Standard problem-details response containing machine-readable
                  and human-readable information about an HTTP API error.
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                description: >-
                  Standard problem-details response containing machine-readable
                  and human-readable information about an HTTP API error.
            text/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ProblemDetails'
                description: >-
                  Standard problem-details response containing machine-readable
                  and human-readable information about an HTTP API error.
components:
  schemas:
    MessageMediaAttachment:
      type: object
      properties:
        url:
          type: string
          description: URL from which the media attachment can be retrieved.
        contentType:
          type:
            - 'null'
            - string
          description: MIME content type of the media attachment.
        size:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          description: Size of the media attachment in bytes.
          format: int64
        sha256:
          type:
            - 'null'
            - string
          description: SHA-256 digest of the media content, when available.
        fileName:
          type:
            - 'null'
            - string
          description: Original file name of the media attachment, when available.
      description: Media attached to an SMS/MMS conversation event.
    ProblemDetails:
      type: object
      properties:
        type:
          type:
            - 'null'
            - string
          description: URI reference that identifies the problem type.
        title:
          type:
            - 'null'
            - string
          description: Short, human-readable summary of the problem.
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          description: HTTP status code returned for the problem.
          format: int32
        detail:
          type:
            - 'null'
            - string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
        instance:
          type:
            - 'null'
            - string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
      description: >-
        Standard problem-details response containing machine-readable and
        human-readable information about an HTTP API error.

````