curl -X POST https://api.tracklysms.com/api/v2/accounts/children/1042/suspend \
-H "X-Api-Key: trk_your_parent_key"
{
"child": {
"accountId": 1042,
"name": "Acme West",
"status": "suspended",
"plan": "paid",
"externalIds": { "partnerId": "p_1", "businessId": "b_9", "locationId": "loc_west" },
"billedByParent": true,
"createdAt": "2026-07-26T14:03:11.123456"
}
}
Partner Accounts (v2)
Suspend Child Account
Pause a child account — its API keys stop authenticating and billing pauses.
POST
/
v2
/
accounts
/
children
/
{child_id}
/
suspend
curl -X POST https://api.tracklysms.com/api/v2/accounts/children/1042/suspend \
-H "X-Api-Key: trk_your_parent_key"
{
"child": {
"accountId": 1042,
"name": "Acme West",
"status": "suspended",
"plan": "paid",
"externalIds": { "partnerId": "p_1", "businessId": "b_9", "locationId": "loc_west" },
"billedByParent": true,
"createdAt": "2026-07-26T14:03:11.123456"
}
}
Suspends a child to immediately stop it from sending: its API keys stop authenticating (
403 account_suspended) and its billing pauses. Idempotent — a no-op if the child is already suspended. Requires a parent key with accounts.write. Reactivate to resume.
Path Parameters
integer
required
The child account’s
accountId.Examples
curl -X POST https://api.tracklysms.com/api/v2/accounts/children/1042/suspend \
-H "X-Api-Key: trk_your_parent_key"
{
"child": {
"accountId": 1042,
"name": "Acme West",
"status": "suspended",
"plan": "paid",
"externalIds": { "partnerId": "p_1", "businessId": "b_9", "locationId": "loc_west" },
"billedByParent": true,
"createdAt": "2026-07-26T14:03:11.123456"
}
}
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 404 | child_not_found | No child with that ID under this parent. |
| 409 | child_deleted | The child has been deleted. |
| 409 | account_creation_incomplete | The child is still mid-creation and cannot be modified. |
| 403 | not_a_parent_account / insufficient_scope / sandbox_read_only | See Accounts & Hierarchy. |
Suspending a child does not revoke its keys — reactivating restores them. To permanently disable a key, revoke it.