Bulk Subscriber Actions

For more information on how to use these endpoints see: Bulk Create/Update Subscribers

• Bulk Create Subscribers POST /subscribers/bulk

• Bulk Update Subscribers PATCH /subscribers/bulk

Bulk Create Subscribers

post

Record Limit

This endpoint will accept a maximum of 1,000 records in a single request. Records of subscribers should be in an array. The createOnly field indicates if the action is creating new subscribers only (doesn't accept records of existing subscribers) or the action is creating or updating (accept records of existing subscribers and update info according to the records).

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

Authorizations

bearerAuth

Query parameters

createOnlystringOptional

Bodyobject[]

application/json

firstNamestringOptional

lastNamestringOptional

emailstringOptional

numberone ofOptional

numberOptional

or

stringOptional

e164NumberstringOptional

groupIdsnumber[]Optional

employeeNumberstringOptional

welcomeMessagestringOptional

Responses

200

Success

application/json

Responseall of

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

429

RateLimitError

application/json

500

InternalServerError

application/json

post

HTTPcURLJavaScriptPython

POST /v3/subscribers/bulk HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 203

[
  {
    "firstName": "text",
    "lastName": "text",
    "email": "text",
    "number": 1,
    "e164Number": "text",
    "groupIds": [
      1
    ],
    "subscriberFields": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "employeeNumber": "text",
    "welcomeMessage": "text"
  }
]

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": {
    "totalRecordCount": 1,
    "createdRecordCount": 1,
    "errorRecordCount": 1,
    "createdRecords": [
      {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "number": 1,
        "e164Number": "text",
        "date": "2025-10-13T16:10:26.757Z",
        "countryId": 1,
        "groups": [
          {
            "id": 1,
            "name": "text",
            "addedToGroupAt": "2025-10-13T16:10:26.757Z"
          }
        ],
        "subscriberFieldData": [
          {
            "id": 1,
            "subscriberFieldId": 1,
            "data": "text"
          }
        ],
        "signupMethod": 1,
        "longNumber": 1,
        "carrierId": 1
      }
    ],
    "errorRecords": [
      {
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "number": 1,
        "e164Number": "text",
        "groupIds": [
          1
        ],
        "subscriberFields": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "employeeNumber": "text",
        "welcomeMessage": "text",
        "error": "text"
      }
    ]
  }
}

Bulk Update Subscribers

patch

Record Limit

This endpoint will accept a maximum of 1,000 records in a single request.

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

Authorizations

bearerAuth

Bodyone of[]

application/json

BulkUpdateSubscribers.RequestRecord

itemsone ofOptional

BulkUpdateSubscribers.RequestRecord

all ofOptional

BulkUpdateSubscribers.RequestWithId

or

all ofOptional

BulkUpdateSubscribers.RequestWithPhoneNumber

or

all ofOptional

BulkUpdateSubscribers.RequestWithEmail

Responses

200

Success

application/json

Responseall of

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

429

RateLimitError

application/json

500

InternalServerError

application/json

patch

HTTPcURLJavaScriptPython

PATCH /v3/subscribers/bulk HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 221

[
  {
    "record": {
      "firstName": "text",
      "lastName": "text",
      "email": "text",
      "number": 1,
      "e164Number": "text",
      "groupIds": [
        1
      ],
      "subscriberFields": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "employeeNumber": "text",
      "welcomeMessage": "text"
    },
    "id": 1
  }
]

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": {
    "totalRecordCount": 1,
    "updatedRecordCount": 1,
    "errorRecordCount": 1,
    "updatedRecords": [
      {
        "record": {
          "id": 1,
          "firstName": "text",
          "lastName": "text",
          "email": "text",
          "number": 1,
          "e164Number": "text",
          "date": "2025-10-13T16:10:26.757Z",
          "countryId": 1,
          "groups": [
            {
              "id": 1,
              "name": "text",
              "addedToGroupAt": "2025-10-13T16:10:26.757Z"
            }
          ],
          "subscriberFieldData": [
            {
              "id": 1,
              "subscriberFieldId": 1,
              "data": "text"
            }
          ],
          "signupMethod": 1,
          "longNumber": 1,
          "carrierId": 1
        },
        "id": 1
      }
    ],
    "errorRecords": [
      {
        "error": "text",
        "id": 1
      }
    ]
  }
}