> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Child Account

Subscribe supports two-level account hierarchies for payment and reporting; that is, you may define parent and children accounts. A parent can have multiple children, but a child may have only one parent, and a child may not be a parent to another Account.

A parent can pay for its own [Subscriptions](Subscriptions) or one-time [Transactions](Transactions), or for any of its children’s Subscriptions or one-time transactions. (This is handled by allowing a parent’s Payment Method to be on a Subscription with the child’s Account.)

Children may have Payment Methods that differ from their Parent’s, and may use either theirs or their parent’s to pay for their Subscriptions.

## HTTP Request

`POST https://api.vindicia.com/accounts/:account/children`

## Route (URL) Parameters

| Parameter | Default | Description | Required |
| - | - | - | - |
| account | n/a | The **id** or the **vid** of the Account to add a child account | Yes |

## Query Parameters

| Parameter | Default | Description | Required |
| - | - | - | - |
| force | false | force will override any existing parent accounts of the child account | No |
| payer\_replacement\_behavior | `ReplaceOnlyFuture AutoBills` | Can be `ReplaceOnAllAutoBills`, `ReplaceOnlyFutureAutoBills` | No |

## Accepts

JSON - A new or existing [Account](Accounts).

## Returns

JSON - An [Account](Accounts) object.

**Parent topic:**[Accounts](../topics/Accounts)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.