---
title: "Create account"
method: POST
path: "/accounts"
tags: ["Accounts"]
---

# Create account

`POST /accounts`

Create a new account.

Required scope: `accounts:write`

## Request body

- Account
  - `name` string — Name of the Account
  - `description` string — Account description
  - `domains` string[] — List of domains associated with the Account
  - `external_id` string — ID of the Account in an external system
  - `custom_fields` CustomFieldParameter — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields

## Response `201`

An Account

- AccountResponse
  - `_links` object, required
    - `self` string — Link to resource
    - `related` object
      - `contacts` string — Link to contacts associated to the account
  - `id` string, required — Unique identifier of the account
  - `name` string, required — Account name
  - `logo_url` string, nullable, required — URL of the Account's logo
  - `description` string, nullable, required — Account Description
  - `domains` string[], required — List of domains associated to the Account
  - `external_id` string, nullable, required — ID of the Account in an External system, such as your backoffice system or CRM
  - `custom_fields` CustomFieldParameter, required — An object whose key is the `name` property defined for the custom field in the Front UI. The value of the key must use the same `type` specified for the custom field, as described in https://dev.frontapp.com/reference/custom-fields
  - `created_at` number — Timestamp when the account was created
  - `updated_at` number — Timestamp when the account was updated

---

[API](https://skmtc.net/frontapp/apis/core-api.md) · [All operations](https://skmtc.net/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)