Upsert an Account

curl --request PUT \
  --url https://api.example.com/v1/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": "acc_abc123",
    "name": "Acme Corp",
    "status": "NEW",
    "notes": "Key enterprise prospect",
    "company": {
      "domain": "acme.com"
    },
    "tags": [
      "Enterprise"
    ],
    "created_at": "2025-06-15T10:30:00Z",
    "custom_field_7a1c9e2b-3f4d-4a8e-9b1c-2d3e4f5a6b7c": "high"
  },
  "meta": {
    "timestamp": "2026-04-21T12:00:00Z"
  }
}

Accounts

Upsert an Account

Creates a new account or updates an existing one. domain is required and is used as the primary identifier for matching.

Duplicate resolution — the request is matched against existing accounts in the org by exact match on domain. If a match is found, that account is updated in place with the provided fields and returned; otherwise a new account is created (a company record for the domain must exist in our data sources).

Enrichment — on creation, Monaco synchronously enriches the account with company firmographic data (industry, employee count, funding, etc.). This can make create requests take several seconds to complete; clients should use generous timeouts (10s+) and avoid issuing creates on hot paths.

Any tags list provided is appended to the existing tags on the account.

PUT

accounts

Upsert an Account

curl --request PUT \
  --url https://api.example.com/v1/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": "acc_abc123",
    "name": "Acme Corp",
    "status": "NEW",
    "notes": "Key enterprise prospect",
    "company": {
      "domain": "acme.com"
    },
    "tags": [
      "Enterprise"
    ],
    "created_at": "2025-06-15T10:30:00Z",
    "custom_field_7a1c9e2b-3f4d-4a8e-9b1c-2d3e4f5a6b7c": "high"
  },
  "meta": {
    "timestamp": "2026-04-21T12:00:00Z"
  }
}

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

Response

Successful Response

data

AccountResponse · object

required

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

Show child attributes

API

Documentation Index

Body

Response