---
title: "POST /v1/master_accounts"
method: POST
path: "/v1/master_accounts"
tags: ["MasterAccount"]
---

# POST /v1/master_accounts

`POST /v1/master_accounts`

Creates a new master account under a CoreStack account. There can be multiple tenants within a CoreStack account.

## Request body

- CreateMasterAccountRequest
  - `name` string, required — Name of the master account. It can be only alphanumeric
  - `subscription_info` MasterAccountSubscription
    - `action` string — Action will be create for project master creation
    - `subscription_id` string — Subscription id of user
  - `tenant_name` string, required — Tenant name. It can be only alphanumeric
  - `crm_id` string — CRM id
  - `sso_tenant_id` string — SSO tenant id
  - `mfa_enabled` boolean — Flag to enable MFA for the master account
  - `custom_tags` KeyValuePair[] — List of tag key/value pairs
    - `key` string — Key of the pair
    - `value` string — Value of the pair
  - `third_party_subscription_details` ThirdPartySubscription
    - `provider` string — Provider of subscription
    - `type` 'marketplace' — Type of subscription
    - `subscription_name` string — Subscription Name
    - `subscription_id` string — Subscription ID
    - `plan_id` string — Plan ID
    - `offer_id` string — Offer ID
    - `purchaser_email` string — Purchaser Email Id
    - `activation_details` ActivationDetails
      - `status` 'activated' | 'failed' | 'pending_activation' — Status of the activation details
      - `message` string — Message of the activation details
  - `products` string[] — Products to enable
  - `notification_settings` MasterAccountNotificationSetting
    - `organization_name` string — Organization name
    - `support_email` string — Support email
    - `activation_email` string — Activation email
    - `activation_email_type` string — Activation email type
    - `email_template` string — Email Template
    - `custom_domain_name` string — Custom domain name
    - `header_logo` string — Header Logo
    - `banner_logo` string — Banner Logo
    - `footer_text` string — Footer text
    - `template_type` string — Type of template
    - `email_settings` MasterAccountEmailSetting
      - `smtp` string, required — SMTP
      - `smtp_port` integer, required — Smtp port no
      - `username` string, required — User name
      - `email` string, required — Email
      - `password` string, required — Password for email
      - `enable_starttls` boolean — Enable Starttls
    - `to_address` string — To Address
    - `subject` string — Subject
    - `message` string — Message
    - `user_guide_url` string — User Guide URL
    - `support_url` string — Support URL
    - `terms_and_conditions_url` string — Terms and Conditions URL
    - `support_tool_account_id` string — Integrated Tool for support system
  - `fiscal_year_configuration` FiscalYearConfiguration
    - `start` string — Start Date for Financial Year in DD-MMM format
    - `end` string — End Date for Financial Year in DD-MMM format
  - `hierarchy_level` string — Hierarchy level
  - `parent_master_account_id` string — ID of the parent master account.
  - `require_access_key` boolean — Flag to set API keys generation is allowed or not for the users of this master account.

## Response `201`

Created

- CreateMasterAccountResponse
  - `id` string — Account master id
  - `status` string — Account master status
  - `tenant_id` string — Tenant id
  - `role_info` RoleInfoModel
    - `tenant_id` string — Tenant id
    - `roles` string[] — list of role ids assigned to user

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)