Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Textmagic Messages API

Send and manage outbound SMS messages.

Textmagic Messages API is one of 11 APIs that Textmagic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Messages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 4 paths, and defines 6 schemas. It is described by OpenAPI 3.0.1, at version 2.0.

Requests are made against a single base URL, https://rest.textmagic.com/api/v2.

6 operations 4 paths 6 schemas 1 DELETE4 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2.0
Base URL
https://rest.textmagic.com/api/v2
Authentication
API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

Textmagic Messages API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-TM-Username (TmUsername). An API key is passed in the header as X-TM-Key (TmKey). By default, every request must be authenticated.

  • TmUsername — Your Textmagic account username.
  • TmKey — Your Textmagic API key, generated in the account settings.

Paths & Operations 6

Across 4 paths, the API surfaces 6 operations — 1 DELETE, 4 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Messages 6

Send and manage outbound SMS messages.

GET
/messages
Get all outbound messages
getMessages 2 params → 200
POST
/messages
Send a message
sendMessage body → 201400401
GET
/messages/{id}
Get a single message
getMessage 1 param → 200404
DELETE
/messages/{id}
Delete a message
deleteMessage 1 param → 204404
GET
/messages/search
Find messages by criteria
searchMessages 3 params → 200
GET
/messages/price/normalized
Check message price
getMessagePrice 2 params → 200

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are Message (12 properties), SendMessageRequest (7 properties), SendMessageResponse (7 properties), MessageList (4 properties). Each schema is shown below with its type and property counts.

MessagePrice
object
3 properties
SendMessageResponse
object
7 properties
SendMessageRequest
object
7 properties 1 required
MessageList
object
4 properties
Message
object
12 properties
Error
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

textmagic-messages-api-openapi.yml Raw ↑

Other APIs Textmagic publishes across the network.

Textmagic Bulk API
Textmagic Chats API
Textmagic Contacts API
Textmagic Lists API
Textmagic Numbers API
Textmagic Replies API
Textmagic Schedules API
Textmagic Sender IDs API
Textmagic Stats API
Textmagic Templates API