Learn how to use the Mobile Text Alerts API to add a subscriber to your account
The MTA API allows you to view, add, edit, and remove subscribers from your account just like you can from the platform dashboard page. This page will guide you through adding a subscriber with the API.
Subscribers can be added via the API with a POST request to the /subscribers endpoint. A phone number (number) or email address (email) is required. If you add a phone number or email of a subscriber that already exists on the account, this will update the existing subscriber with any changes.
Below is an example cURL POST request to the /subscribers endpoint to add a new subscriber.
To view all possible request parameters see:
If valid, a response will be returned with the message: "Subscriber created successfully."
View more Subscriber API Endpoints
curl -XPOST --location 'https://api.mobile-text-alerts.com/v3/subscribers' \
--header 'Authorization: Bearer 89fa747a-e01b-5940-99c2-4e96fa996258'
--header 'Content-Type:application/json' \
--data-raw '{
"firstName": "FirstName",
"lastName": "LastName",
"number": 8002223333,
"email": "[email protected]"
}'//Example successful response
{
"message":"Subscriber created successfully.",
"data":
{
"id":109021633,
"firstName":"FirstName",
"lastName":"LastName",
"email":"[email protected]",
"number":8002223333,
"e164Number":"+18002223333",
"date":{"val":"CURRENT_TIMESTAMP"},
"countryId":209,
"groups":[],
"subscriberFieldData":[],
"signupMethod":5,
"longNumber":8002223333,
"carrierId":"41"
}
}Add a new subscriber. If given a phone number or email that already exists tied to the same account, updates the existing subscriber with new information
Required Fields: email or number
This endpoint overrides the general rate limit with an account rate limit. Requests are limited by the authenticated account instead of the IP address. This endpoint is limited to 15 requests every 15 seconds
SubscriberRequest
Success
BadRequestError
UnauthorizedError
ForbiddenError
RateLimitError
InternalServerError
{
"success": true,
"error": "text",
"message": "text",
"data": {
"id": 1,
"firstName": "text",
"lastName": "text",
"email": "text",
"number": 1,
"e164Number": "text",
"date": "2025-12-15T01:36:05.583Z",
"countryId": 1,
"groups": [
{
"id": 1,
"name": "text",
"addedToGroupAt": "2025-12-15T01:36:05.583Z"
}
],
"subscriberFieldData": [
{
"id": 1,
"subscriberFieldId": 1,
"data": "text"
}
],
"signupMethod": 1,
"longNumber": 1,
"carrierId": 1
}
}POST /v3/subscribers HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 181
{
"firstName": "text",
"lastName": "text",
"email": "text",
"number": 1,
"groupIds": [
1
],
"subscriberFields": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"employeeNumber": "text",
"welcomeMessage": "text"
}