---
title: "Create a sub-organization."
method: POST
path: "/print-mail/v1/sub_organizations"
tags: ["Sub-Organizations"]
---

# Create a sub-organization.

`POST /print-mail/v1/sub_organizations`

When creating a user through the API, the verifiedEmail field will automatically be
set to true. However, if public signups are used, the email will need to be verified
by the user.

## Request body

- SubOrganizationCreate
  - `name` string, required — The name of the user to be created alongside the sub-organization.
  - `email` string, required — The email of the user to be created alongside the sub-organization.
  - `password` string, required — The password of the user to be created alongside the sub-organization.
  - `phoneNumber` string — The phone number of the user to be created alongside the sub-organization.
  - `organizationName` string, required — The name of the sub-organization.
  - `countryCode` string, required — The country code of the sub-organization.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- object
  - `user` User, required — The user object.
    - `id` string, required — A unique ID prefixed with `user_`.
    - `organization` string, required — A unique ID prefixed with `user_`.
    - `pendingInvite` boolean, required — Indicates if the user has a pending invite.
    - `email` string, required — The email of the user.
    - `name` string, required — The name of the user.
    - `phoneNumber` string — The phone number of the user.
    - `lastLoginTime` string, date-time — The date and time at which the user last logged in.
    - `verifiedEmail` boolean, required — Indicates if the user has a verified email or not.
    - `roles` string[], required — The roles given to the user. Roles can be used to restrict access for users.
    - `previousEmails` string[] — A list of emails the user has previously had. If a user has changed their email before, this list will be populated with all of the emails they once had.
    - `emailPreferences` EmailPreferences — A set of preferences for how a user should receive emails.
      - `orderPreviewSendPreference` 'do_not_send' | 'send_live_only' | 'send_live_and_test' — The list of preferences for receiving order preview emails.
    - `apiKeys` APIKey[], required — The user's API keys. Contains live and test mode API keys.
      - `value` string, required — The value of the API key.
      - `activeUntil` string, date-time — An optional date which the API key is active until. After this date, the API key will no longer be valid.
  - `subOrganization` SubOrganization, required — The Sub-Organization object.
    - `id` string, required — A unique ID prefixed with `sub_org_`.
    - `object` 'sub_org', required — Always `sub_org`.
    - `name` string, required — The name of the sub-organization.
    - `countryCode` string, required — The country code of the sub-organization.
    - `limit` integer, required — The limit of mailings the sub-organization can send before being charged overages for the month.
    - `spend` integer, required — The current rolling charge for the sub-organization for the month, in cents.
    - `usage` integer, required — The amount of mail the sub-organization has sent out this month.
    - `createdAt` string, date-time, required — The UTC time at which this resource was created.
    - `updatedAt` string, date-time, required — The UTC time at which this resource was last update.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `404` — The server cannot find the requested resource.
- `422` — Client error
- `429` — Client error
- `500` — Server error

---

[API](https://skmtc.net/postgrid/apis/postgrid-address-verification-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-address-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-address-verification-api/revisions/537d2bbc624a/schema)