Skip to main content
PATCH
Update an Account

Path Parameters

account_id
string<uuid>
required

Body

application/json
company_name
string | null

Company name

Example:

"Acme Corporation"

linkedin_url
string | null

LinkedIn company page URL

Example:

"https://linkedin.com/company/acme"

description
string | null

Company description

employee_count
integer | null

Number of employees

Required range: x >= 0
Example:

250

founded_year
integer | null

Year the company was founded

Example:

2019

estimated_annual_revenue_usd
number | null

Estimated annual revenue in USD

Required range: x >= 0
Example:

12000000

total_funding_usd
number | null

Total funding raised in USD

Required range: x >= 0
Example:

50000000

last_funding_round
enum<string> | null

Type of the most recent funding round

Available options:
pre_seed,
seed,
angel,
series_a,
series_b,
series_c,
series_d,
series_e,
series_f,
series_g,
series_h,
series_i,
series_j,
series_unknown,
private_equity,
debt_financing,
convertible_note,
grant,
non_equity_assistance,
corporate_round,
equity_crowdfunding,
product_crowdfunding,
initial_coin_offering,
secondary_market,
post_ipo_equity,
post_ipo_debt,
post_ipo_secondary,
undisclosed
Example:

"series_b"

last_funding_date
string<date> | null

Date of the most recent funding round

Example:

"2024-03-15"

industries
string[] | null

Industries from Monaco's standard list. Replaces the current list

Example:
business_model
enum<string> | null

Business model

Available options:
B2B,
B2C
Example:

"B2B"

company_status
enum<string> | null

Operating status of the company

Available options:
active,
acquired,
out_of_business,
ipo,
unknown
Example:

"active"

location
string | null

Headquarters as city, state, country

Example:

"San Francisco, CA, United States"

name
string | null

Display name for the account

Example:

"Acme Corp"

status
enum<string> | null

Account status

Available options:
NEW,
PROSPECTING,
OPPORTUNITY,
CUSTOMER,
DISQUALIFIED,
NURTURE,
INBOUND,
CHURNED
Example:

"PROSPECTING"

notes
string | null

Notes about the account

owner
string<uuid> | null

User ID to assign as account owner

tags
string<uuid>[] | null

Tag IDs for the account. Replaces the account's existing tags.

parent_account
string<uuid> | null

Account ID to set as this account's parent, or null to make it top-level. The parent must be a top-level account in the same workspace.

domains
string[] | null

The account's complete list of domains. Replaces the whole list: domains left out are removed from the account. The first domain is the primary. Omit the field (or send null) to leave the domains unchanged; send [] to remove them all. A domain another account in the workspace already uses is rejected with domain_conflict, naming that account.

Maximum array length: 500
Example:
company_id
string<uuid> | null

ID of the company to link; null unlinks

replace_edited_fields
boolean
default:false

Also replace fields a user has edited

Response

Successful Response

data
AccountWriteResponse · object
required

Account returned by a single-account update.

meta
ResponseMeta · object