v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Create an account

Creates a new account record. The $name field is required.

If a $website is provided, Lightfield automatically enriches the account in the background. The $howTheyMakeMoney and $accountStatus fields are read-only and cannot be set via the API. The $opportunity, $task, $note, and $meeting relationships are also read-only — manage them via the $account relationship on the opportunity or task, the $account/$opportunity note relationships, or via the meeting's $contact attendees that belong to this account.

Supports idempotency via the Idempotency-Key header.

To avoid duplicates, we recommend a find-or-create pattern — use <u>list filtering</u> to check if a record exists before creating.

Required scope: accounts:create

Rate limit category: Write

post/v1/accounts

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Request body

Response

OK

idstring required

Unique identifier for the entity.

createdAtstring required

ISO 8601 timestamp of when the entity was created.

updatedAtstring nullable required

ISO 8601 timestamp of when the entity was last updated, or null.

httpLinkstring nullable required

URL to view the entity in the Lightfield web app, or null.

externalIdstring nullable

External identifier for the entity, or null if unset.

fieldsobject required

Map of field names to their typed values. System fields are prefixed with $ (e.g. $name, $email); custom attributes use their bare slug.

relationshipsobject required

Map of relationship names to their associated entities. System relationships are prefixed with $ (e.g. $owner, $contact).