A group is a set of phone numbers (or MSISDNs) that can be used as a target when sending an SMS. An phone number (MSISDN) can only occur once in a group and any attempts to add a duplicate are ignored but not rejected.
With the list operation you can list all groups that you have created. This operation supports pagination.
Groups are returned in reverse chronological order.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
A successful response, or an Error.
{- "page": 50,
- "page_size": 50,
- "count": 1,
- "groups": [
- {
- "name": "string",
- "members": [
- "+453234457784"
], - "child_groups": [
- "string"
], - "auto_update": {
- "to": "string",
- "add": {
- "first_word": "string",
- "second_word": "string"
}, - "remove": {
- "first_word": "string",
- "second_word": "string"
}
}
}
]
}
A group is a set of phone numbers (MSISDNs) that can be used as a target in the send_batch_msg
operation. An MSISDN can only occur once in a group and any attempts to add a duplicate would be ignored but not rejected.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
name | string <= 20 characters Name of the group |
members | |
child_groups | Array of strings <= 10 items Phone numbers (MSISDNs) of child group will be included in this group. If present then this group will be auto populated. Constraints: Elements must be group IDs. |
object |
Created, or an Error.
{- "members": [
- "member_MSISDNs",
- "as_strings_in_array",
- "16051234567"
], - "name": "YOUR_group_name"
}
{- "id": "01FC66621XXXXX119Z8PMV1QPU",
- "name": "My new customers",
- "size": 2,
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "child_groups": [
- "01FC66621XXXXX119Z8PMV1AHY"
], - "auto_update": {
- "to": 15551231234,
- "add": "string",
- "remove": "string"
}
}
This operation retrieves a specific group with the provided group ID.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
group_id required | string ID of a group that you are interested in getting. |
A successful response, or an Error.
{- "id": "01FC66621XXXXX119Z8PMV1QPU",
- "name": "My new customers",
- "size": 2,
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "child_groups": [
- "01FC66621XXXXX119Z8PMV1AHY"
], - "auto_update": {
- "to": 15551231234,
- "add": "string",
- "remove": "string"
}
}
With the update group operation, you can add and remove members in an existing group as well as rename the group.
This method encompasses a few ways to update a group:
add
and remove
arrays containing phone numbers, you control the group movements. Any list of valid numbers in E.164 format can be added.auto_update
object, your customer can add or remove themselves from groups. add_from_group
and remove_from_group
.service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
group_id required | string ID of a group that you are interested in getting. |
name | string or null <= 20 characters The name of the group. Omitting |
add | Array of arrays Add a list of phone numbers (MSISDNs) to this group. The phone numbers are a strings within an array and must be in E.164 format. |
remove | Array of arrays Remove a list of phone numbers (MSISDNs) to this group.The phone numbers are a strings within an array and must be in E.164 format. |
add_from_group | string Copy the members from the another group into this group. Constraints: Must be valid group ID |
remove_from_group | string Remove the members in a specified group from this group. Constraints: Must be valid group ID |
object |
A successful response, or an Error.
{- "add": [
- "+14058961234",
- "+447911123456",
- "+55987654321"
], - "remove": [
- "+4612345678",
- "+15551235555"
]
}
{- "id": "01FC66621XXXXX119Z8PMV1QPU",
- "name": "My new customers",
- "size": 2,
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "child_groups": [
- "01FC66621XXXXX119Z8PMV1AHY"
], - "auto_update": {
- "to": 15551231234,
- "add": "string",
- "remove": "string"
}
}
The replace operation will replace all parameters, including members, of an existing group with new values.
Replacing a group targeted by a batch message scheduled in the future is allowed and changes will be reflected when the batch is sent.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
group_id required | string ID of a group that you are interested in getting. |
members required | Array of strings <E.164> (msisdn) <= 10000 items The initial members of the group. Constraints: Elements must be phone numbers in E.164 format MSISDNs. |
name | string <= 20 items Name of group. |
A successful response, or an Error.
{- "members": [
- "123456789",
- "987654321"
], - "name": "New Name of the Group"
}
{- "id": "01FC66621XXXXX119Z8PMV1QPU",
- "name": "My new customers",
- "size": 2,
- "created_at": "2019-08-24T14:15:22Z",
- "modified_at": "2019-08-24T14:15:22Z",
- "child_groups": [
- "01FC66621XXXXX119Z8PMV1AHY"
], - "auto_update": {
- "to": 15551231234,
- "add": "string",
- "remove": "string"
}
}
This operation deletes the group with the provided group ID.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
group_id required | string ID of a group that you are interested in getting. |
A successful response , or an Error.
This operation retrieves the members of the group with the provided group ID.
service_plan_id required | string Your service plan ID. You can find this on your Dashboard. Example: jd63jf88477ll123ab4567cd89012ef3 |
group_id required | string ID of a group that you are interested in getting. |
[- "+453234457784"
]