> For the complete documentation index, see [llms.txt](https://api.senderwiz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.senderwiz.com/customer/subaccounts/create-a-subaccount.md).

# Create a Subaccount

### 🆕 Create a Subaccount

Add a new subaccount to your SenderWiz customer account with first name, last name, email, password, and timezone.

***

#### 🔹 HTTP Request

```http
POST API-URL/children
```

***

#### 📤 POST Parameters

| Parameter    | Type   | Required | Description                     |
| ------------ | ------ | -------- | ------------------------------- |
| `first_name` | string | ✅        | First name of the subaccount    |
| `last_name`  | string | ✅        | Last name of the subaccount     |
| `email`      | string | ✅        | Email address of the subaccount |
| `password`   | string | ✅        | Login password                  |
| `timezone`   | string | ✅        | Timezone (e.g., Asia/Kolkata)   |

***

#### 🔐 Authorization Headers

```http
X-API-KEY: your-api-key-here
```

***

#### 💻 PHP Example

```php
// CREATE A SUBACCOUNT
$response = $endpoint->createChild([
    'first_name' => 'Sophia',
    'last_name'  => 'Green',
    'email'      => 'sophia.green@demo.com',
    'password'   => 'StrongPass#2025',
    'timezone'   => 'America/New_York'
]);

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';
```

***

#### 📦 Sample JSON Response

```json
{
  "status": "success",
  "data": {
    "child_uid": "8e12c91b4a2d1",
    "first_name": "Sophia",
    "last_name": "Green",
    "email": "sophia.green@demo.com",
    "timezone": "America/New_York",
    "status": "active",
    "date_added": "2025-06-04 14:22:11"
  }
}
```

***

#### 🧾 Notes

* Use the returned `child_uid` to perform updates, deletions, or permission management.
* Ensure the email used is unique across the account.