---
title: "Create Business Profile"
method: POST
path: "/api/v1/business-profile"
tags: ["business-profiles"]
---

# Create Business Profile

`POST /api/v1/business-profile`

Create a business profile for PO eligibility. 400 if one already exists.

## Request body

- BusinessProfileCreate — Create a new business profile for PO eligibility.
  - `company_name` string, required
  - `tax_id` string, nullable
  - `billing_email` string, nullable
  - `billing_address` string, required
  - `shipping_address` string, required
  - `payment_terms` string, required

## Response `201`

Successful Response

- AppSchemasBusinessProfileBusinessProfileResponse — User-facing business profile response.
  - `id` string, uuid, required
  - `user_id` string, uuid, required
  - `company_name` string, required
  - `tax_id` string, nullable
  - `billing_email` string, nullable
  - `billing_address` string, required
  - `shipping_address` string, required
  - `payment_terms` string, required
  - `credit_limit` string, nullable
  - `is_tax_exempt` boolean
  - `tax_exempt_cert_r2_key` string, nullable
  - `is_approved_for_po` boolean, required
  - `po_approval_date` string, date-time, nullable
  - `approved_by` string, nullable
  - `notes` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

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