Skip to main content
PUT
/
v1
/
preview
/
accounts
Upsert Account
curl --request PUT \
  --url https://api.example.com/v1/preview/accounts/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "<string>",
  "linkedin_url": "https://linkedin.com/company/acme",
  "name": "Acme Corp",
  "status": "NEW",
  "notes": "Key enterprise prospect",
  "owner": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tags": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'
{
  "data": {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "name": "Acme Corp",
    "status": "active",
    "owner": {
      "id": "<string>",
      "first_name": "Jane",
      "last_name": "Smith"
    },
    "notes": "Key enterprise prospect",
    "company": {
      "domain": "acme.com",
      "linkedin_url": "https://linkedin.com/company/acme",
      "description": "Enterprise software company specializing in AI-driven sales tools",
      "employee_count": 250,
      "founded_year": 2019,
      "industries": [
        "<string>"
      ],
      "total_funding_usd": 50000000,
      "last_funding_date": "2024-03-15"
    },
    "scoring": {
      "tier": "A",
      "heat_score": "Hot"
    },
    "tags": [
      "<string>"
    ]
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.monaco.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json

Request body for upserting an account.

Custom fields can be passed as additional keys prefixed with custom_field_.

domain
string
required

Company domain for matching or creating the account

Example:

"acme.com"

linkedin_url
string | null

LinkedIn company page URL for matching or creating the account

Example:

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

name
string | null

Display name for the account

Example:

"Acme Corp"

status
string | null

Account status

Example:

"NEW"

notes
string | null

Notes about the account

Example:

"Key enterprise prospect"

owner
string<uuid> | null

User ID to assign as account owner

tags
string<uuid>[] | null

List of tag IDs to associate with the account

Response

Successful Response

data
AccountResponse · object
required

Account resource. Custom fields appear as additional keys prefixed with custom_field_.

meta
ResponseMeta · object