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

# Send Message (URL-Encoded)

> Sends an SMS message using URL-encoded form-data parameters or query-string parameters.




## OpenAPI

````yaml openapi/url-legacy.yaml POST /sendmessage.aspx
openapi: 3.1.2
info:
  title: Phonovation SMS URL-Encoded Legacy API
  version: 1.0.6
  description: >
    Send SMS messages through Phonovation using the classic URL-encoded API.


    This legacy interface is designed for existing integrations that submit
    form-style parameters to send immediate or scheduled messages, including
    optional customer reference IDs for delivery tracking.


    For new integrations, use the Phonovation SMS OAuth API where possible.
servers:
  - url: https://secure.interactsms.com/api/v1
    description: Phonovation SMS Legacy API Server
security: []
tags:
  - name: Bulk SMS API
    description: Phonovation SMS legacy URL-encoded API endpoints.
paths:
  /sendmessage.aspx:
    post:
      tags:
        - Bulk SMS API
      summary: Send an SMS message (URL-encoded)
      description: >
        Sends an SMS message using URL-encoded form-data parameters or
        query-string parameters.
      operationId: SendUrlEncodedMessage
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              oneOf:
                - $ref: '#/components/schemas/SendMessageForm'
            examples:
              basicMessage:
                summary: Basic message
                value:
                  user: YOUR_USERNAME
                  password: YOUR_PASSWORD
                  api_id: 1234
                  to: '353861234567'
                  text: Hello World
                  from: YourCompany
              futureMessage:
                summary: Future message
                value:
                  user: YOUR_USERNAME
                  password: YOUR_PASSWORD
                  api_id: 1234
                  to: '353861234567'
                  text: Hello World
                  from: YourCompany
                  deliverytime: 0
              messageWithNotifyId:
                summary: Message with NotifyId
                value:
                  user: YOUR_USERNAME
                  password: YOUR_PASSWORD
                  api_id: 1234
                  to: '353861234567'
                  text: Hello World
                  from: YourCompany
                  notify_id: order-001
              futureMessageWithNotifyId:
                summary: Future message + NotifyId
                value:
                  user: YOUR_USERNAME
                  password: YOUR_PASSWORD
                  api_id: 1234
                  to: '353861234567'
                  text: Hello World
                  from: YourCompany
                  notify_id: order-001
                  deliverytime: 0
      responses:
        '200':
          description: API always returns HTTP 200. Body contains raw text response.
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/SendMessageTextResponse'
              examples:
                success_deferred:
                  summary: Success - message deferred
                  value: |
                    0
                    Request deferred successfully
                invalid_msisdns:
                  summary: Invalid MSISDN(s)
                  value: >
                    1

                    Error With Query String. No valid MSISDNS found. Invalid
                    numbers found > {numbers}
                generic_query_error:
                  summary: Query string error
                  value: |
                    1
                    Error With Query String
                invalid_user:
                  summary: Incorrect username/password
                  value: |
                    7
                    Username and Password don't match any client.
                not_enough_credit:
                  summary: Insufficient credit
                  value: |
                    5
                    Not enough credit
                senderid_unregistered:
                  summary: Sender ID requires registration
                  value: >
                    5

                    SenderID requires registration, contact
                    support@phonovation.com
                from_required:
                  summary: From field missing
                  value: |
                    5
                    The 'From' field is required and cannot be left blank
                empty_text:
                  summary: SMS content empty
                  value: |
                    5
                    Content text is empty
                long_text:
                  summary: SMS content too long
                  value: |
                    5
                    Message can't be more than 160 characters
                validation_error:
                  summary: General validation error
                  value: |
                    5
                    Error in Validate: {message}
                message_failed:
                  summary: Message failure
                  value: |
                    5
                    Message couldn't be sent
                invalid_format:
                  summary: Invalid format exception
                  value: |
                    8
                    Invalid string format.
      security: []
components:
  schemas:
    SendMessageForm:
      type: object
      description: Form fields accepted by the URL-encoded SMS API.
      properties:
        user:
          type: string
        password:
          type: string
          format: password
        api_id:
          type: integer
        to:
          type: string
          description: Destination mobile number in international format.
        text:
          type: string
        from:
          type: string
          description: Sender address (alphanumeric or shortcode).
        notify_id:
          type: string
          description: Optional callback notification identifier.
        deliverytime:
          type: integer
          description: Unix timestamp or 0 for immediate delivery.
      required:
        - user
        - password
        - api_id
        - to
        - text
        - from
    SendMessageTextResponse:
      type: string
      description: >-
        Raw text response. The first line contains the legacy status code;
        following text contains the result message.

````