Microsoft Skype Sms API

The Sms API from Microsoft Skype — 1 operation(s) for sms.

Operations 1

POST /sms Sends a SMS message from a phone number that belongs to the authenticated… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-skype:microsoft-skype-sms-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-skype-sms-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Microsoft Skype Sms API
  version: '2026-01-23'
  description: 'Operations tagged Sms across 2 of this provider''s published API definitions: acs-sms-2026-01-23.json, microsoft-skype-sms-openapi.yml. Each path carries the servers of the definition it was published in.'
tags:
- name: SMS
paths:
  /sms:
    post:
      tags:
      - SMS
      summary: Sends a SMS message from a phone number that belongs to the authenticated…
      operationId: Sms_Send
      x-ms-examples:
        SuccessfulSend:
          $ref: ./examples/SmsSend.json
      parameters:
      - name: api-version
        in: query
        description: Version of API to invoke.
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SmsSendResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendMessageRequest'
        description: Represents the body of the send message request.
        required: true
components:
  schemas:
    SmsRecipient:
      description: Recipient details for sending SMS messages.
      required:
      - to
      type: object
      properties:
        to:
          description: The recipient's phone number in E.164 format.
          type: string
        repeatabilityRequestId:
          description: If specified, the client directs that the request is repeatable; that is, the client can make the request multiple times with the same Repeatability-Request-ID and get back an appropriate response without the server executing the request multiple times. The value of the Repeatability-Request-ID is an opaque string representing a client-generated, 36-character hexadecimal case-insensitive encoding of a UUID (GUID), identifier for the request.
          type: string
        repeatabilityFirstSent:
          description: MUST be sent by clients to specify that a request is repeatable. Repeatability-First-Sent is used to specify the date and time at which the request was first created.eg- Tue, 26 Mar 2019 16:06:51 GMT
          type: string
    SmsSendResponseItem:
      description: Response for a single recipient.
      required:
      - httpStatusCode
      - to
      - successful
      type: object
      properties:
        to:
          description: The recipient's phone number in E.164 format.
          type: string
        messageId:
          description: The identifier of the outgoing Sms message. Only present if message processed.
          type: string
        httpStatusCode:
          format: int32
          description: HTTP Status code.
          type: integer
        repeatabilityResult:
          description: The result of a repeatable request with one of the case-insensitive values accepted or rejected.
          type: string
          enum:
          - accepted
          - rejected
        successful:
          description: Indicates if the message is processed successfully or not.
          type: boolean
        errorMessage:
          description: Optional error message in case of 4xx/5xx/repeatable errors.
          type: string
    ErrorDetail:
      description: Error detail information.
      required:
      - code
      - message
      type: object
      properties:
        code:
          description: The error code.
          type: string
        message:
          description: The error message.
          type: string
        innerError:
          description: Additional error details.
          type: object
    StandardErrorResponse:
      description: Standard error response format.
      required:
      - error
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
    MessagingConnectOptions:
      description: Defines optional parameters for connecting with the Messaging Connect Partner to deliver SMS.
      required:
      - partner
      - partnerParams
      type: object
      properties:
        partner:
          description: Specifies the partner name for message delivery.
          type: string
        partnerParams:
          description: Partner-specific parameters as key-value pairs. Must contain at least one parameter required by the messaging connect partner (e.g., apiKey, servicePlanId, authToken, etc.).
          type: object
          minProperties: 1
    BadRequestErrorResponse:
      description: Bad Request error response that can represent both validation errors and standard API errors.
      type: object
      properties:
        type:
          description: A URI reference that identifies the problem type (for validation errors).
          type: string
        title:
          description: A short, human-readable summary of the problem type (for validation errors).
          type: string
        status:
          description: The HTTP status code (for validation errors).
          type: integer
          format: int32
        errors:
          description: Dictionary of field-specific validation errors (for validation errors).
          type: object
          additionalProperties:
            type: array
            items:
              type: string
        traceId:
          description: The trace identifier for the request (for validation errors).
          type: string
        error:
          description: Error detail information (for standard API errors).
          $ref: '#/components/schemas/ErrorDetail'
    SmsSendOptions:
      description: Optional configuration for sending SMS messages.
      required:
      - enableDeliveryReport
      type: object
      properties:
        enableDeliveryReport:
          description: Enable this flag to receive a delivery report for this message on the Azure Resource EventGrid.
          type: boolean
        tag:
          description: Use this field to provide metadata that will then be sent back in the corresponding Delivery Report.
          type: string
        deliveryReportTimeoutInSeconds:
          format: int32
          description: Time to wait for a delivery report. After this time a delivery report with timeout error code is generated.
          maximum: 43200
          minimum: 60
          type: integer
        messagingConnect:
          $ref: '#/components/schemas/MessagingConnectOptions'
    SmsSendResponse:
      description: Response for a successful or multi status send Sms request.
      required:
      - value
      type: object
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/SmsSendResponseItem'
    SendMessageRequest:
      description: Represents the properties of a send message request.
      required:
      - message
      - smsRecipients
      - from
      type: object
      properties:
        from:
          description: The sender's phone number in E.164 format that is owned by the authenticated account.
          type: string
        smsRecipients:
          description: The recipient's phone number in E.164 format. In this version, a minimum of 1 and upto 100 recipients in the list are supported.
          maxLength: 100
          minLength: 1
          type: array
          items:
            $ref: '#/components/schemas/SmsRecipient'
        message:
          description: The contents of the message that will be sent to the recipient. The allowable content is defined by RFC 5724.
          maxLength: 2048
          minLength: 0
          type: string
        smsSendOptions:
          $ref: '#/components/schemas/SmsSendOptions'
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow
x-refined-from:
- acs-sms-2026-01-23.json
- microsoft-skype-sms-openapi.yml
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'