---
title: "Post Accounts"
method: POST
path: "/crm/accounts"
tags: ["CRM Service Calls"]
---

# Post Accounts

`POST /crm/accounts`

Create a new account (company/organization).

Only `name` is required. Defaults: source="Unknown", status="customer",
relationship_type="customer".

**Request Body (AccountRequest):**

- **name** *(required)*: Account name.
- **email**, **phone** *(optional)*: Primary contact info.
- **source** *(default: "Unknown")*: Marketing source.
- **status** *(default: "customer")*: Values: open, assigned, attempted, contacted,
  meeting-setup, customer, lost-followup, lost, inactive, incorrect, disqualified,
  prospect, ex-customer.
- **relationship_type** *(default: "customer")*: Values: customer, vendor, partner, prospect, other.
- **tags** *(optional)*: Up to 10 tags.
- **website**, **company_name**, **description**, **industry**, **num_employees** *(optional)*.
- **social_dict_list** *(optional)*: Social profiles, e.g. `[{"type": "linkedin", "url": "..."}]`.

**Response:** The created account object.

## Request body

- AccountRequest — Request to create a new account (company/organization).
  - `name` string, required — Account name
  - `email` string, nullable
  - `phone` string, nullable
  - `source` string, nullable — Marketing source, e.g. Google, Facebook, Referral, Unknown
  - `status` string, nullable — Possible values: open, assigned, attempted, contacted, meeting-setup, customer, lost-followup, lost, inactive, incorrect, disqualified, prospect, ex-customer
  - `relationship_type` 'customer' | 'vendor' | 'partner' | 'prospect' | 'other', nullable — Possible values: customer, vendor, partner, prospect, other
  - `tags` string[], nullable — List of tags (maximum 10 tags allowed)
  - `website` string, nullable — Company website URL
  - `company_name` string, nullable — Company display name
  - `description` string, nullable — Account description / notes
  - `industry` string, nullable — Industry sector, e.g. technology, healthcare, other
  - `num_employees` integer, nullable — Number of employees
  - `social_dict_list` object[], nullable — List of social profiles, e.g. [{"type": "linkedin", "url": "https://linkedin.com/company/..."}]

## Response `200`

Successful Response

- AccountResponse
  - `id` string, required
  - `name` string, required
  - `phone_list` unknown[], nullable
    - unknown
  - `email_list` unknown[], nullable
    - unknown
  - `status` string, nullable
  - `source` string, nullable
  - `relationship_type` string, nullable
  - `website` string, nullable
  - `company_name` string, nullable
  - `description` string, nullable
  - `industry` string, nullable
  - `num_employees` integer, nullable
  - `tags` string[], nullable
  - `social_dict_list` object[], nullable
  - `created_date` string, nullable
  - `updated_date` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)