## Create an account
**post** `/v1/accounts`
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 [list filtering](/using-the-api/list-endpoints/#filtering) to check if a record exists before creating.
**[Required scope](/using-the-api/scopes/):** `accounts:create`
**[Rate limit category](/using-the-api/rate-limits/):** Write
### Body Parameters
- `fields: object { "$name", "$facebook", "$headcount", 7 more } or map[string or number or boolean or 3 more]`
Field values for the new account. System fields use a `$` prefix (e.g. `$name`, `$website`); custom attributes use their bare slug (e.g. `tier`, `renewalDate`). Required: `$name` (string). Fields of type `SINGLE_SELECT` or `MULTI_SELECT` accept either an option ID or label from the field's `typeConfiguration.options` — call the [definitions endpoint](/api/resources/account/methods/definitions) to discover available fields and options. See [Fields and relationships](/using-the-api/fields-and-relationships/) for value type details.
- `Typed object { "$name", "$facebook", "$headcount", 7 more }`
- `"$name": string`
Display name of the account.
- `"$facebook": optional string`
Facebook handle or profile identifier (`SOCIAL_HANDLE`).
- `"$headcount": optional string`
Employee count range (`SINGLE_SELECT`). Pass the option ID or label from the field definition.
- `"$industry": optional array of string`
Industries the account operates in (`MULTI_SELECT`). Pass option IDs or labels from the field definition.
- `"$instagram": optional string`
Instagram handle or profile identifier (`SOCIAL_HANDLE`).
- `"$lastFundingType": optional string`
Most recent funding round type (`SINGLE_SELECT`). Pass the option ID or label from the field definition.
- `"$linkedIn": optional string`
LinkedIn handle or profile identifier (`SOCIAL_HANDLE`).
- `"$primaryAddress": optional object { city, country, latitude, 5 more }`
Primary address (`ADDRESS`).
- `city: optional string`
City name.
- `country: optional string`
2-letter ISO 3166-1 alpha-2 country code.
- `latitude: optional number`
Latitude coordinate.
- `longitude: optional number`
Longitude coordinate.
- `postalCode: optional string`
Postal or ZIP code.
- `state: optional string`
State or province.
- `street: optional string`
Street address line 1.
- `street2: optional string`
Street address line 2.
- `"$twitter": optional string`
Twitter/X handle (`SOCIAL_HANDLE`).
- `"$website": optional array of string`
Website URLs associated with the account (`URL`, multi-value).
- `Untyped = map[string or number or boolean or 3 more]`
- `string`
- `number`
- `boolean`
- `array of string`
- `Address object { city, country, latitude, 5 more }`
- `city: optional string`
City name.
- `country: optional string`
2-letter ISO 3166-1 alpha-2 country code.
- `latitude: optional number`
Latitude coordinate.
- `longitude: optional number`
Longitude coordinate.
- `postalCode: optional string`
Postal or ZIP code.
- `state: optional string`
State or province.
- `street: optional string`
Street address line 1.
- `street2: optional string`
Street address line 2.
- `FullName object { firstName, lastName }`
- `firstName: optional string`
The contact's first name.
- `lastName: optional string`
The contact's last name.
- `relationships: optional object { "$account-slack-channel", "$contact", "$files", "$owner" } or map[string or array of string]`
Relationships to set on the new account. System relationships use a `$` prefix (e.g. `$owner`, `$contact`); custom relationships use their bare slug. Each value is a single entity ID or an array of IDs. Call the [definitions endpoint](/api/resources/account/methods/definitions) to list available relationship keys.
- `Typed object { "$account-slack-channel", "$contact", "$files", "$owner" }`
- `"$account-slack-channel": optional string or array of string`
Slack channel ID(s) to link to this account. Pass Lightfield channel IDs (prefixed `chn_`); the channel must belong to the organization’s connected Slack workspace.
- `string`
- `array of string`
- `"$contact": optional string or array of string`
ID(s) of contacts to associate with this account.
- `string`
- `array of string`
- `"$files": optional string or array of string`
File ID(s) to attach to this account. Files must be in `completed` status.
- `string`
- `array of string`
- `"$owner": optional string or array of string`
ID of the user who owns this account.
- `string`
- `array of string`
- `Untyped = map[string or array of string]`
- `string`
- `array of string`
### Returns
- `AccountCreateResponse object { id, createdAt, fields, 4 more }`
- `id: string`
Unique identifier for the entity.
- `createdAt: string`
ISO 8601 timestamp of when the entity was created.
- `fields: map[object { value, valueType } ]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `value: string or number or boolean or 3 more`
The field value, or null if unset.
- `string`
- `number`
- `boolean`
- `array of string`
- `Address object { city, country, latitude, 5 more }`
- `city: optional string`
City name.
- `country: optional string`
2-letter ISO 3166-1 alpha-2 country code.
- `latitude: optional number`
Latitude coordinate.
- `longitude: optional number`
Longitude coordinate.
- `postalCode: optional string`
Postal or ZIP code.
- `state: optional string`
State or province.
- `street: optional string`
Street address line 1.
- `street2: optional string`
Street address line 2.
- `FullName object { firstName, lastName }`
- `firstName: optional string`
The contact's first name.
- `lastName: optional string`
The contact's last name.
- `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 12 more`
The data type of the field.
- `"ADDRESS"`
- `"CHECKBOX"`
- `"CURRENCY"`
- `"DATETIME"`
- `"EMAIL"`
- `"FULL_NAME"`
- `"MARKDOWN"`
- `"MULTI_SELECT"`
- `"NUMBER"`
- `"SINGLE_SELECT"`
- `"SOCIAL_HANDLE"`
- `"TELEPHONE"`
- `"TEXT"`
- `"URL"`
- `"HTML"`
- `httpLink: string`
URL to view the entity in the Lightfield web app, or null.
- `relationships: map[object { cardinality, objectType, values } ]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `cardinality: string`
Whether the relationship is `has_one` or `has_many`.
- `objectType: string`
The type of the related object (e.g. `account`, `contact`).
- `values: array of string`
IDs of the related entities.
- `updatedAt: string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `externalId: optional string`
External identifier for the entity, or null if unset.
### Example
```http
curl https://api.lightfield.app/v1/accounts \
-H 'Content-Type: application/json' \
-H 'Lightfield-Version: 2026-03-01' \
-H "Authorization: Bearer $API_KEY" \
-d '{
"fields": {
"$name": "$name"
}
}'
```
#### Response
```json
{
"id": "id",
"createdAt": "createdAt",
"fields": {
"foo": {
"value": "string",
"valueType": "ADDRESS"
}
},
"httpLink": "httpLink",
"relationships": {
"foo": {
"cardinality": "cardinality",
"objectType": "objectType",
"values": [
"string"
]
}
},
"updatedAt": "updatedAt",
"externalId": "externalId"
}
```