Twilio

Twilio Messaging Services API

Configure messaging services for scalable messaging

Documentation GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /Services List messaging services · Twilio List Messaging Services #

Ask an LLM

“Which messaging services exist on my account?”

“Can I see all my messaging services and their settings in one list?”

Tell an agent

List my messaging services.

Show my messaging services, {page_size} per page.

POST /Services Create a messaging service · Twilio Create a Messaging Service #

Ask an LLM

“How do I set up a messaging service to manage a pool of senders?”

“Can a new messaging service keep the same sender for each recipient and match local area codes?”

Tell an agent

Create a messaging service called {friendly_name}.

Create messaging service {friendly_name} that sends inbound messages to {inbound_url}.

GET /Services/{ServiceSid} View a messaging service · Twilio Fetch a Messaging Service #

Ask an LLM

“What webhooks and sender settings does a given messaging service use?”

“Can I look up one messaging service by its SID?”

Tell an agent

Fetch messaging service {service_sid}.

Show the configuration of messaging service {service_sid}.

POST /Services/{ServiceSid} Change a messaging service's settings · Twilio Update a Messaging Service #

Ask an LLM

“Can I change the inbound webhook or status callback on an existing messaging service?”

“Is it possible to turn on smart encoding for a messaging service I already have?”

Tell an agent

Rename messaging service {service_sid} to {friendly_name}.

Update messaging service {service_sid} ({friendly_name}) to post delivery status to {status_callback}.

DELETE /Services/{ServiceSid} Delete a messaging service · Twilio Delete a Messaging Service #

Ask an LLM

“Can I remove a messaging service I no longer need?”

“What happens to a messaging service once it's deleted?”

Tell an agent destructive · confirm first

Delete messaging service {service_sid}.

Remove the messaging service {service_sid} from my account.

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/twilio-messaging-services-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Twilio Messaging Messaging Services API
  description: Send and receive SMS and MMS messages globally using Twilio's Messaging API. Supports programmable messaging, messaging services, alphanumeric sender IDs, A2P 10DLC registration, toll-free verification, and link shortening.
  version: '2.0'
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://www.twilio.com/legal/tos
servers:
- url: https://api.twilio.com/2010-04-01
  description: Twilio REST API v1
- url: https://messaging.twilio.com/v1
  description: Twilio Messaging Service API
security:
- accountSid_authToken: []
tags:
- name: Messaging Services
  description: Configure messaging services for scalable messaging
paths:
  /Services:
    get:
      operationId: listMessagingServices
      summary: Twilio List Messaging Services
      description: Retrieve a list of messaging services associated with your account.
      tags:
      - Messaging Services
      parameters:
      - name: PageSize
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      responses:
        '200':
          description: List of messaging services
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessagingServiceList'
        '401':
          description: Unauthorized
    post:
      operationId: createMessagingService
      summary: Twilio Create a Messaging Service
      description: Create a new messaging service for managing senders and message configuration at scale.
      tags:
      - Messaging Services
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateMessagingServiceRequest'
      responses:
        '201':
          description: Messaging service created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessagingService'
        '400':
          description: Invalid request
        '401':
          description: Unauthorized
  /Services/{ServiceSid}:
    get:
      operationId: fetchMessagingService
      summary: Twilio Fetch a Messaging Service
      tags:
      - Messaging Services
      parameters:
      - $ref: '#/components/parameters/ServiceSid'
      responses:
        '200':
          description: Messaging service details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessagingService'
        '404':
          description: Service not found
    post:
      operationId: updateMessagingService
      summary: Twilio Update a Messaging Service
      tags:
      - Messaging Services
      parameters:
      - $ref: '#/components/parameters/ServiceSid'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateMessagingServiceRequest'
      responses:
        '200':
          description: Messaging service updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessagingService'
        '400':
          description: Invalid request
    delete:
      operationId: deleteMessagingService
      summary: Twilio Delete a Messaging Service
      tags:
      - Messaging Services
      parameters:
      - $ref: '#/components/parameters/ServiceSid'
      responses:
        '204':
          description: Messaging service deleted
        '404':
          description: Service not found
components:
  schemas:
    PaginationMeta:
      type: object
      properties:
        page:
          type: integer
        page_size:
          type: integer
        first_page_url:
          type: string
          format: uri
        previous_page_url:
          type: string
          format: uri
        next_page_url:
          type: string
          format: uri
        url:
          type: string
          format: uri
        key:
          type: string
    CreateMessagingServiceRequest:
      type: object
      required:
      - FriendlyName
      properties:
        FriendlyName:
          type: string
          description: Descriptive name for the messaging service
        InboundRequestUrl:
          type: string
          format: uri
        InboundMethod:
          type: string
          enum:
          - GET
          - POST
        FallbackUrl:
          type: string
          format: uri
        FallbackMethod:
          type: string
          enum:
          - GET
          - POST
        StatusCallback:
          type: string
          format: uri
        StickySender:
          type: boolean
        SmartEncoding:
          type: boolean
        AreaCodeGeomatch:
          type: boolean
        ValidityPeriod:
          type: integer
    MessagingService:
      type: object
      properties:
        sid:
          type: string
          pattern: ^MG[0-9a-fA-F]{32}$
          description: Unique identifier for the messaging service
        account_sid:
          type: string
          pattern: ^AC[0-9a-fA-F]{32}$
        friendly_name:
          type: string
          description: Descriptive name for the messaging service
        inbound_request_url:
          type: string
          format: uri
          description: URL for incoming message webhooks
        inbound_method:
          type: string
          enum:
          - GET
          - POST
        fallback_url:
          type: string
          format: uri
        fallback_method:
          type: string
          enum:
          - GET
          - POST
        status_callback:
          type: string
          format: uri
          description: URL for delivery status webhooks
        sticky_sender:
          type: boolean
          description: Whether to use sticky sender for conversations
        smart_encoding:
          type: boolean
          description: Whether to automatically detect Unicode characters
        area_code_geomatch:
          type: boolean
          description: Whether to match sender area code to recipient
        validity_period:
          type: integer
          description: Message validity period in seconds
        date_created:
          type: string
          format: date-time
        date_updated:
          type: string
          format: date-time
        url:
          type: string
          format: uri
    MessagingServiceList:
      type: object
      properties:
        services:
          type: array
          items:
            $ref: '#/components/schemas/MessagingService'
        meta:
          $ref: '#/components/schemas/PaginationMeta'
  parameters:
    ServiceSid:
      name: ServiceSid
      in: path
      required: true
      description: The unique identifier of the messaging service
      schema:
        type: string
        pattern: ^MG[0-9a-fA-F]{32}$
  securitySchemes:
    accountSid_authToken:
      type: http
      scheme: basic
      description: Use your Twilio Account SID as the username and Auth Token as the password for HTTP Basic authentication.
externalDocs:
  description: Twilio Messaging API Documentation
  url: https://www.twilio.com/docs/messaging/api

Twilio Messaging Services API

Operations 5

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification