---
title: "Create a business"
method: POST
path: "/businesses"
tags: ["Businesses"]
---

# Create a business

`POST /businesses`

## Request body

- object
  - `name` string, required — The name of the business
  - `metadata` object, nullable — Arbitrary metadata to associate with the business
  - `external_id` string, nullable — An external identifier for the business. Must be unique within the project
  - `website` string, nullable — The website URL for the business

## Response `200`

The created `Business` object

- Business
  - `id` string, required — The ID of the business
  - `external_id` string, nullable, required — The external ID of the business
  - `name` string, required — The name of the business
  - `metadata` object, required — Arbitrary metadata associated with this business
  - `created_at` string, required — The date and time the business was created
  - `website` string, nullable, required — The website URL of the business
  - `disabled_steps` string[], nullable, required — Steps disabled for this business. If `null`, the business inherits the project's `disabled_steps`. If set (including `[]`), this list fully overrides the project's setting.

---

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