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

# Post Accounts

`POST /crm/accounts`

## Request

- Base URL: `https://fapi.ambivo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://fapi.ambivo.com/crm/accounts`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ambivo/apis/ambivo-api/docs/crm/accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-08-06** `165a6d16a9a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ambivo/apis/ambivo-api/changes/crm/accounts/post.md)

---

[API](https://skmtc.dev/ambivo/apis/ambivo-api.md) - [All operations](https://skmtc.dev/ambivo/apis/ambivo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ambivo/apis/ambivo-api/revisions/165a6d16a9a0?raw)