Sign in

v1

latestOpenAPI 3.1.02026-07-263788129.7 KB
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/v1/accounts/

Request body

domainstring required

Company domain for matching or creating the account

linkedin_urlstring nullable

LinkedIn company page URL for matching or creating the account

namestring nullable

Display name for the account

statusstring nullable

Account status

notesstring nullable

Notes about the account

ownerstring uuid nullable

User ID to assign as account owner

tagsstring[] nullable

List of tag IDs to associate with the account

Example request

{
  "domain": "acme.com",
  "linkedin_url": "https://linkedin.com/company/acme",
  "name": "Acme Corp",
  "status": "NEW",
  "notes": "Key enterprise prospect"
}

Response

Successful Response

Example response

{
  "data": {
    "id": "acc_abc123",
    "name": "Acme Corp",
    "status": "active",
    "owner": {
      "id": "usr_abc123",
      "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": [
        "Software",
        "Artificial Intelligence"
      ],
      "total_funding_usd": 50000000,
      "last_funding_date": "2024-03-15"
    },
    "scoring": {
      "tier": "A",
      "heat_score": "Hot"
    },
    "tags": [
      "Enterprise",
      "High Priority"
    ],
    "created_at": "2025-06-15T10:30:00Z",
    "updated_at": "2025-06-15T10:30:00Z"
  }
}