Use the API to obtain a list of the mailing groups on your account. You can use the offset and limit parameters for pagination.
| Parameter | Type | Description |
|---|---|---|
| offset | int | Offset for pagination. |
| limit | int | Limit for pagination. |
curl "https://api-us1.stannp.com/v1/groups" \
-u {API_KEY}:
{
"success": true,
"data": [
{
"id": "398",
"account_id": "1",
"name": "Test Group",
"created": "2015-09-25 11:57:35",
"recipients": "100",
"valid": "98",
"international": "0",
"skipped": "0",
"status": "ready",
"import_progress": "0",
"is_seeds": "0"
},
{
"id": "390",
"account_id": "1",
"name": "My Data",
"created": "2015-09-23 10:50:48",
"recipients": "6000",
"valid": "5872",
"international": "0",
"skipped": "0",
"status": "ready",
"import_progress": "0",
"is_seeds": "0"
}
]
}Use the API to create a new empty mailing list.
| Parameter | Type | Description |
|---|---|---|
| name | string | Name of the new group to be created. |
curl "https://api-us1.stannp.com/v1/groups" \
-u {API_KEY}: \
{
"success": true,
"data": "39"
}Use the API to add recipients from your account to an existing mailing list.
| Parameter | Type | Description |
|---|---|---|
| recipients | string | Comma-separated recipient IDs. |
curl "https://api-us1.stannp.com/v1/groups/{id}/recipients" \
-u {API_KEY}: \
{
"success": true,
"data": 2
}Remove recipients from the group. Note that this only removes the recipient from the group and does not completely delete the recipient.
| Parameter | Type | Description |
|---|---|---|
| recipients | string | Comma-separated recipient IDs. |
curl "https://api-us1.stannp.com/v1/groups/{id}/recipients" \
-u {API_KEY}: \
{
"success": true,
"data": 2
}Use the API to remove all recipients from the mailing list. The recipients will remain on your account if delete_recipients is set to false.
| Parameter | Type | Description |
|---|---|---|
| id | int | ID of the group to purge. |
| delete_recipients | bool | True or false. Delete all recipients in this group if true. Defaults to false. WARNING: If true this will completely delete the recipients so they will not exist in any other groups if the recipient was in multiple groups. |
curl "https://api-us1.stannp.com/v1/groups/{id}/purge" \
-u {API_KEY}: \
{
"success": true,
"data": true
}Will recalculate a group to make sure stats are up to date.
curl "https://api-us1.stannp.com/v1/groups/{id}/recalculate" \
-u {API_KEY}: \
{
"success": true,
"data": true
}Use the API to delete a mailing list. The recipients will remain on your account if delete_recipients is set to false.
| Parameter | Type | Description |
|---|---|---|
| id | int | ID of the group to delete. |
| delete_recipients | bool | True or false. Defaults to false. WARNING: If true this will completely delete the recipients so they will not exist in any other groups if the recipient was in multiple groups. |
curl "https://api-us1.stannp.com/v1/groups/{id}" \
-u {API_KEY}: \
{
"success": true,
"data": true
}