The text.email API
Send texts and manage your text.email account from your apps, scripts, and AI agents.
If your systems already send emails to trigger texts, you can keep using them as they are. The API is an additional option for software that can make HTTPS requests and needs to send messages or manage an account directly.
What you can do
- Send messages: send SMS, MMS, and iMessage through your account, or try anonymous test sending.
- Create an account: sign up, verify your email, and obtain your first API key without visiting the website.
- Manage settings: update message formatting, duplicate prevention, segment limits, attachment handling, acknowledgment preferences, and billing email preferences.
- Control routing: manage your subdomain and aliases, authorized email senders, number replacements, and iMessage routing preferences.
- Manage access: create and revoke API keys, and view or revoke connected apps.
text.email for ChatGPT
The text.email plugin, operated by GMass, Inc., lets you send texts and manage supported account settings and routing directly from ChatGPT. Connect your account with OAuth; you do not need to copy an API key into chat. New users can sign up and verify their email during connection.
Ask ChatGPT to show your settings, change duplicate prevention, list authorized email senders, or send a text to a number you provide. The connection grants full account access through the supported tools and can be revoked in account Settings. Plan limits and message screening apply.
The plugin sends messages immediately. It does not schedule messages, retrieve message history, create distribution lists, buy credits, or cancel subscriptions. Plans and credits are available on the text.email website. The plugin is currently available for private testing while public review is prepared.
Available methods
All paths below use the base URL https://api.text.email/v1.
| Method | Endpoint | Purpose |
|---|---|---|
| Messaging | ||
| POST | /messages | Send a text or media message. |
| GET | /messages | Send a message using a URL. This sends a message; it does not retrieve message history. |
| Signup and verification | ||
| POST | /registrations | Create an account and send its verification email. |
| POST | /registrations/verification | Request another verification email. |
| POST | /registrations/verify | Verify an account using the emailed token. |
| POST | /registrations/api-key | Obtain the first API key for an eligible API-created account using the emailed token. |
| Account and settings | ||
| GET | /account | View account details and status. |
| GET | /account/capabilities | View account capabilities and service availability. |
| GET | /settings | Read account settings. |
| PATCH | /settings | Update selected account settings, including the current subdomain. |
| Email addresses and authorized senders | ||
| GET | /subdomains | View the current subdomain and its aliases. |
| DELETE | /subdomains/aliases/{alias} | Remove a subdomain alias. |
| GET | /authorized-senders | List authorized email senders and domains. |
| POST | /authorized-senders | Add authorized email senders or domains. |
| DELETE | /authorized-senders/{id} | Remove an authorized sender or domain. |
| Number replacements | ||
| GET | /number-replacements | List number replacement rules. |
| PUT | /number-replacements/{number} | Create or update a replacement destination: another number or an existing distribution list. |
| DELETE | /number-replacements/{number} | Remove a number replacement rule. |
| iMessage routing preferences | ||
| GET | /imessage-numbers | List numbers configured to use iMessage for email-to-text delivery. |
| PUT | /imessage-numbers/{number} | Add an iMessage routing preference. |
| DELETE | /imessage-numbers/{number} | Remove an iMessage routing preference. |
| API keys and connected apps | ||
| GET | /api-keys | List API key details without revealing their secrets. |
| POST | /api-keys | Create a new API key for your account. |
| DELETE | /api-keys/{id} | Revoke an API key. |
| GET | /connections | List connected app authorizations. |
| DELETE | /connections/{id} | Revoke a connected app's access. |
Looking for request examples? The API guide explains how to send messages, authenticate sending requests, and handle retries.
Read the messaging API guide