Legacy HTTP API
This documentation refers to the Legacy HTTP API (deprecated). For the current API, see the main API documentation.
The Legacy HTTP API provides basic SMS features using simple HTTP GET/POST requests with query string parameters.
Base URL: https://app.eztexting.com
Authentication: Pass your EZ Texting username and password as User and Password parameters in each request.
Rate Limit: Maximum 2 simultaneous HTTP connections per second.
Send SMS message
POST /sending/messages
Sends an SMS message to one or more recipients.
Parameters:
| Parameter | Required | Description |
|---|---|---|
| User | Yes | EZ Texting username |
| Password | Yes | EZ Texting password |
| PhoneNumbers | Yes | Comma-separated 10-digit phone numbers |
| Message | Yes | Message text (max 160 characters) |
| MessageTypeID | Yes | 1 = Express, 2 = Informed Delivery, 3 = Group |
| StampToSend | No | Scheduled send time (YYYY-MM-DD HH:MM:SS) |
Example Request:
curl "https://app.eztexting.com/sending/messages" \
-d "User=myuser" \
-d "Password=mypass" \
-d "PhoneNumbers=2135551234" \
-d "Message=Hello from EZ Texting" \
-d "MessageTypeID=1"Check credits
GET /api/credits/check/
Returns your current credit balance.
Parameters:
| Parameter | Required | Description |
|---|---|---|
| User | Yes | EZ Texting username |
| Password | Yes | EZ Texting password |
Check keyword availability
GET /api/keyword/check/
Checks if a keyword is available on the shared short code.
Parameters:
| Parameter | Required | Description |
|---|---|---|
| User | Yes | EZ Texting username |
| Password | Yes | EZ Texting password |
| Keyword | Yes | The keyword to check |
Buy credits
POST /api/credits/buy/
Purchases additional credits.
Parameters:
| Parameter | Required | Description |
|---|---|---|
| User | Yes | EZ Texting username |
| Password | Yes | EZ Texting password |
| NumberOfCredits | Yes | Number of credits to purchase |
| CouponCode | No | Coupon code for discount |
Rent keyword
POST /api/keyword/rent/
Rents a keyword on the shared short code.
Parameters:
| Parameter | Required | Description |
|---|---|---|
| User | Yes | EZ Texting username |
| Password | Yes | EZ Texting password |
| Keyword | Yes | The keyword to rent |
Configure keyword
POST /api/keyword/setup/
Configures an existing rented keyword with auto-reply and forwarding settings.
Parameters:
| Parameter | Required | Description |
|---|---|---|
| User | Yes | EZ Texting username |
| Password | Yes | EZ Texting password |
| Keyword | Yes | The keyword to configure |
| EnableDoubleOptIn | No | Enable double opt-in (true/false) |
| ConfirmMessage | No | Opt-in confirmation message |
| JoinMessage | No | Auto-reply when keyword is texted |
| ForwardEmail | No | Email to forward submissions to |
| ForwardUrl | No | URL to forward submissions to |
| Groups | No | Contact groups to add to |
Voice broadcast
POST /api/voicemessages/
Sends voice broadcast messages.
Parameters:
| Parameter | Required | Description |
|---|---|---|
| User | Yes | EZ Texting username |
| Password | Yes | EZ Texting password |
| PhoneNumbers | Yes | Comma-separated phone numbers |
| CallerPhoneNumber | Yes | Caller ID phone number |
| VoiceFile | Yes | Voice message file URL |
| Name | No | Broadcast name |
| StampToSend | No | Scheduled send time |
Return codes
The HTTP API uses numeric return codes instead of HTTP status codes:
| Code | Description |
|---|---|
| 1 | Success |
| -1 | Invalid user and/or password or not authorized to use the API |
| -2 | Credit limit reached |
| -5 | Locally opted-out number |
| -7 | Invalid message or message too long |
| -104 | Invalid phone number |
| -106 | Globally opted-out number |
| -10 | Unknown error |
Carrier lookup (deprecated)
The Carrier Lookup endpoint is deprecated and may be removed in a future update.
GET /api/sending/phone-numbers/
Returns carrier information for a given phone number. This endpoint is deprecated and should not be used for new integrations.
Updated 3 days ago