Group Subscribers

Learn how to create and update groups of subscribers, useful for targeted messaging.

Organizing subscribers into different groups enables you to easily send targeted messages to specific segments. With Mobile Text Alerts, you can add, edit, and remove groups and subscribers via the online dashboard or with the Mobile Text Alerts API, making it easy to keep your contact lists updated.

Manage Groups with the API

The Mobile Text Alerts API allows you to create a group, delete a group, update an existing group's metadata, or view all groups for your account.

Note that these actions are used to make changes to the group itself, not the subscribers that may be contained within the group. See Manage Group Members to see actions for adding/removing subscribers from your groups.

Click here to view the full API Reference for Groups.

Create a new Group

A POST call to the /groups endpoint creates a new group. See below for all additional request fields for group metadata.

Example request

curl -L \
  --request POST \
  --url 'https://api.mobile-text-alerts.com/v3/groups' \
  --header 'Authorization: Bearer 3098eebf-7661-5858-890e-65cd054a0b03' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Example"
  }'

Successful response: "message": "Created group Example."

Request Fields

Name

Type

Description

name - required

string

The name of the group.

hidden

boolean

Indicates if the group is hidden.

description

string

Description of the group.

displayName

string

An alternate display name for this group

sortOrder

number

Override default sorting when displaying this group on the subscriber sign up page

isTemporary

boolean

When set to true, this group is marked as temporary. Temporary groups are deleted at midnight of the day following their creation.

createdAt

string

Timestamp of when the group was created. For example: "2025-05-29T19:04:14.000Z"

settings

object

This field is only used for Adaptive Groups. See Configure settings field for a group to learn more about this field.

Create Group

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

idnumberOptional

accountIdnumberOptional

namestringOptional

hiddennumberOptional

keywordstringOptional

welcomeMessagestringOptional

descriptionstringOptional

parentWebinarIdstringOptional

displayNamestring | nullableOptional

sortOrdernumber | nullableOptional

typestring · enumOptionalPossible values:

isTemporarybooleanOptional

createdAtone ofOptional

string · date-timeOptional

stringOptional

string | nullableOptional

Responses

200

Success

application/json

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

500

InternalServerError

application/json

post

/groups

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

{
  "id": 1,
  "accountId": 1,
  "name": "text",
  "hidden": 1,
  "keyword": "text",
  "welcomeMessage": "text",
  "description": "text",
  "parentWebinarId": "text",
  "displayName": "text",
  "sortOrder": 1,
  "type": "static",
  "settings": {
    "match": "AND",
    "conditions": [
      {
        "type": "text",
        "conditionAttribute": "text",
        "conditionOperator": "equals",
        "conditionCategory": "text",
        "conditionValue": [
          "text"
        ],
        "conditionSubOperator": "equals",
        "conditionSubValue": [
          "text"
        ],
        "shouldLoadDefaultValue": true
      }
    ]
  },
  "isTemporary": true,
  "createdAt": "2026-01-24T13:17:53.076Z"
}

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": {
    "id": 1,
    "name": "text",
    "hidden": 1,
    "welcomeMessage": "text",
    "description": "text",
    "parentWebinarId": "text",
    "displayName": "text",
    "sortOrder": 1,
    "type": "static",
    "settings": {
      "match": "AND",
      "conditions": [
        {
          "type": "text",
          "conditionAttribute": "text",
          "conditionOperator": "equals",
          "conditionCategory": "text",
          "conditionValue": [
            "text"
          ],
          "conditionSubOperator": "equals",
          "conditionSubValue": [
            "text"
          ],
          "shouldLoadDefaultValue": true
        }
      ]
    },
    "isTemporary": true,
    "createdAt": "2026-01-24T13:17:53.076Z",
    "memberCount": 1
  }
}

Delete Group

Groups can be deleted without needing to supply a request body. Simply include the {groupId} of the group to be deleted as a path parameter with your DELETE request.

Example Request

In the example below, we delete groupId: 187561.

curl --request DELETE --location 'https://api.mobile-text-alerts.com/v3/groups/187561' \
  --header 'Authorization: Bearer 3098eebf-7661-5858-890e-65cd054a0b03'

Successful Response: {"message":"Group deleted successfully."}

Delete Group

delete

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupIdstringRequired

Responses

200

Success

application/json

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

500

InternalServerError

application/json

delete

/groups/{groupId}

DELETE /v3/groups/{groupId} HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": null
}

Update Groups

The fields that contain group metadata can be added or updated at any time by calling the PATCH /groups/{groupId} endpoint with the identifying {groupId} of the group to be updated. See below for all optional request fields that contain group metadata.

Example Request

In the example below, we update groupId: 187561.

curl -L \
  --request PATCH \
  --url 'https://api.mobile-text-alerts.com/v3/groups/187561' \
  --header 'Authorization: Bearer 3098eebf-7661-5858-890e-65cd054a0b03' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "New Name"
  }'

Successful response: "message": "Updated group New Name."

Request Fields

Name

Type

Description

name - required

string

The name of the group.

hidden

boolean

Indicates if the group is hidden.

description

string

Description of the group.

displayName

string

An alternate display name for this group

sortOrder

number

Override default sorting when displaying this group on the subscriber sign up page

isTemporary

boolean

When set to true, this group is marked as temporary. Temporary groups are deleted at midnight of the day following their creation.

createdAt

string

Timestamp of when the group was created. For example: "2025-05-29T19:04:14.000Z"

settings

object

This field is only used for Adaptive Groups. See Configure settings field for a group to learn more about this field.

Update Group

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupIdstringRequired

Body

idnumberOptional

accountIdnumberOptional

namestringOptional

hiddennumberOptional

keywordstringOptional

welcomeMessagestringOptional

descriptionstringOptional

parentWebinarIdstringOptional

displayNamestring | nullableOptional

sortOrdernumber | nullableOptional

typestring · enumOptionalPossible values:

isTemporarybooleanOptional

createdAtone ofOptional

string · date-timeOptional

stringOptional

string | nullableOptional

Responses

200

Success

application/json

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

500

InternalServerError

application/json

patch

/groups/{groupId}

PATCH /v3/groups/{groupId} HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 502

{
  "id": 1,
  "accountId": 1,
  "name": "text",
  "hidden": 1,
  "keyword": "text",
  "welcomeMessage": "text",
  "description": "text",
  "parentWebinarId": "text",
  "displayName": "text",
  "sortOrder": 1,
  "type": "static",
  "settings": {
    "match": "AND",
    "conditions": [
      {
        "type": "text",
        "conditionAttribute": "text",
        "conditionOperator": "equals",
        "conditionCategory": "text",
        "conditionValue": [
          "text"
        ],
        "conditionSubOperator": "equals",
        "conditionSubValue": [
          "text"
        ],
        "shouldLoadDefaultValue": true
      }
    ]
  },
  "isTemporary": true,
  "createdAt": "2026-01-24T13:17:53.076Z"
}

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": {
    "id": 1,
    "name": "text",
    "hidden": 1,
    "welcomeMessage": "text",
    "description": "text",
    "parentWebinarId": "text",
    "displayName": "text",
    "sortOrder": 1,
    "type": "static",
    "settings": {
      "match": "AND",
      "conditions": [
        {
          "type": "text",
          "conditionAttribute": "text",
          "conditionOperator": "equals",
          "conditionCategory": "text",
          "conditionValue": [
            "text"
          ],
          "conditionSubOperator": "equals",
          "conditionSubValue": [
            "text"
          ],
          "shouldLoadDefaultValue": true
        }
      ]
    },
    "isTemporary": true,
    "createdAt": "2026-01-24T13:17:53.076Z",
    "memberCount": 1
  }
}

List All Groups

Call the GET /groups endpoint to see the groups on your account.

This endpoint does not show adaptive groups by default, see List Adaptive Groups to learn more.

This endpoint produces paginated results. You may need to make multiple queries to retrieve every group on your account.

Query responses include the following data:

page - the current page of results being shown
pageSize - number of groups shown per page
total - the total number of groups on your account

Example Request

curl --location 'https://api.mobile-text-alerts.com/v3/groups' \
  --header 'Authorization: Bearer 3098eebf-7661-5858-890e-65cd054a0b03'

Successful response:

{"data":
    {"rows":
    [{"id":187561,
        "name":"Test Group",
        "hidden":0,
        "displayName":null,
        "welcomeMessage":"",
        "sortOrder":null,
        "description":"First group created for testing.",
        "createdAt":"2025-05-29T19:04:14.000Z",
        "memberCount":0,"type":"static"},
    {"id":187572,
        "name":"API-Test",
        "hidden":0,
        "displayName":null,
        "welcomeMessage":"",
        "sortOrder":null,
        "description":null,
        "createdAt":"2025-05-29T14:47:26.000Z",
        "memberCount":0,"type":"static"}],
"page":0,"pageSize":25,"total":2}}

List Groups

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pagenumberOptional

pageSizenumberOptional

sortBystringOptional

sortDirectionstring · enumOptionalPossible values:

querystringOptional

Responses

200

Success

application/json

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

500

InternalServerError

application/json

get

/groups

GET /v3/groups HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": {
    "rows": [
      {
        "id": 1,
        "name": "text",
        "hidden": 1,
        "welcomeMessage": "text",
        "description": "text",
        "parentWebinarId": "text",
        "displayName": "text",
        "sortOrder": 1,
        "type": "static",
        "settings": {
          "match": "AND",
          "conditions": [
            {
              "type": "text",
              "conditionAttribute": "text",
              "conditionOperator": "equals",
              "conditionCategory": "text",
              "conditionValue": [
                "text"
              ],
              "conditionSubOperator": "equals",
              "conditionSubValue": [
                "text"
              ],
              "shouldLoadDefaultValue": true
            }
          ]
        },
        "isTemporary": true,
        "createdAt": "2026-01-24T13:17:53.076Z",
        "memberCount": 1
      }
    ],
    "page": 1,
    "pageSize": 1,
    "total": 1
  }
}

Manage Group Members

Subscribers can be added or deleted from your groups with the API endpoints documented below.

If you need to add or delete many group members in a single request, see Groups Bulk Add/Delete Subscribers for bulk endpoints that can accept up to 1,000 records in a single request.

Add Subscriber to Group

To add a subscriber to a group, you need both the subscriberId and the groupId. The subscriberId is passed in the request body, and the groupId is specified as a path parameter.

Example request:

In the example below, we add subscriberId: 108767117 to groupId: 187561.

curl -X POST --location 'https://api.mobile-text-alerts.com/v3/groups/187561/subscribers' \
  --header 'Authorization: Bearer 3098eebf-7661-5858-890e-65cd054a0b03' \
  --header 'Content-Type: application/json' \
  --data '{"subscriberId":108767117}'

Successful response: {"message":"Added subscriber 108767117 to group 187561."}

By default, when adding a subscriber to a group, the addToDripCampaigns field is set to true. Set this field to false if you don't want this subscriber included in drip campaigns.

Add Subscriber to Group

post

Required Fields: subscriberId

Note: Field addToDripCampaigns is true by default.

undefined

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupIdstringRequired

Body

subscriberIdnumberRequired

addToDripCampaignsbooleanOptional

Responses

200

Success

application/json

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

500

InternalServerError

application/json

post

/groups/{groupId}/subscribers

POST /v3/groups/{groupId}/subscribers HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "subscriberId": 1,
  "addToDripCampaigns": true
}

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": null
}

Delete Group Member

Subscribers can be removed from a group by identifying them with the groupId and subscriberId in the path parameters to the DELETE /groups/{groupId}/subscribers/{subscriberId} endpoint.

Example request

In the example below, we delete subscriberId: 108767117 from groupId: 187561.

curl --request DELETE --location 'https://api.mobile-text-alerts.com/v3/groups/187561/subscribers/108767117' \
  --header 'Authorization: Bearer 3098eebf-7661-5858-890e-65cd054a0b03'

Successful Response: {"message":"Deleted subscriber 108767117 from group 187561."}

Remove Subscriber from Group

delete

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupIdstringRequired

subscriberIdstringRequired

Responses

200

Success

application/json

400

BadRequestError

application/json

401

UnauthorizedError

application/json

403

ForbiddenError

application/json

500

InternalServerError

application/json

delete

/groups/{groupId}/subscribers/{subscriberId}

DELETE /v3/groups/{groupId}/subscribers/{subscriberId} HTTP/1.1
Host: api.mobile-text-alerts.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "error": "text",
  "message": "text",
  "data": null
}

PreviousAssign Custom Subscriber Attributes NextAdaptive Groups

Last updated 7 days ago

Was this helpful?

hashtagManage Groups with the API

hashtagCreate a new Group

hashtagExample request

hashtagRequest Fields

hashtagCreate Group

hashtagDelete Group

hashtagExample Request

hashtagDelete Group

hashtagUpdate Groups

hashtagExample Request

hashtagRequest Fields

hashtagUpdate Group

hashtagList All Groups

hashtagExample Request

hashtagList Groups

hashtagManage Group Members

hashtagAdd Subscriber to Group

hashtagExample request:

hashtagAdd Subscriber to Group

hashtagDelete Group Member

hashtagExample request

hashtagRemove Subscriber from Group

Manage Groups with the API

Create a new Group

Example request

Request Fields

Create Group

Delete Group

Example Request

Delete Group

Update Groups

Example Request

Request Fields

Update Group

List All Groups

Example Request

List Groups

Manage Group Members

Add Subscriber to Group

Example request:

Add Subscriber to Group

Delete Group Member

Example request

Remove Subscriber from Group