Add a Subscriber
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.
Add a Subscriber with the Mobile Text Alerts 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.
Example request to add a subscriber
Below is an example cURL POST request to the /subscribers endpoint to add a new subscriber.
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]"
}'To view all possible request parameters see: Create Subscriber API Endpoint
Example Response
If valid, a response will be returned with the message: "Subscriber created successfully."
//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
Rate Limiting
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
POST /v3/subscribers HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer apiKey
Content-Type: application/json
Accept: */*
{
"statusCode": "MTANoLinkedAccountError",
"success": true,
"error": "text",
"message": "text",
"data": {
"id": 1,
"firstName": "text",
"lastName": "text",
"email": "text",
"number": 1,
"e164Number": "text",
"date": "2025-06-21T22:09:22.270Z",
"countryId": 1,
"groups": [
{
"id": 1,
"name": "text",
"addedToGroupAt": "2025-06-21T22:09:22.270Z"
}
],
"subscriberFieldData": [
{
"id": 1,
"subscriberFieldId": 1,
"data": "text"
}
],
"signupMethod": 1,
"longNumber": 1
}
}View more Subscriber API Endpoints
Last updated
Was this helpful?