Skip to content

API Reference

Libraries

npm install lightfield
pip install lightfield

API Overview

Account

Accounts represent companies or organizations in Lightfield. Each account can have contacts, opportunities, tasks, and notes associated with it.

Get account field definitions
GET/v1/accounts/definitions
Create an account
POST/v1/accounts
Update an account
POST/v1/accounts/{id}
Retrieve an account
GET/v1/accounts/{id}
List accounts
GET/v1/accounts

Contact

Contacts represent individual people in Lightfield. Contacts can be associated with one or more accounts.

Get contact field definitions
GET/v1/contacts/definitions
Create a contact
POST/v1/contacts
Update a contact
POST/v1/contacts/{id}
Retrieve a contact
GET/v1/contacts/{id}
List contacts
GET/v1/contacts

List

Lists are curated collections of accounts, contacts, or opportunities in Lightfield. Each list contains entities of a single type.

Create a list
POST/v1/lists
Update a list
POST/v1/lists/{id}
Retrieve a list
GET/v1/lists/{id}
List lists
GET/v1/lists
List accounts in a list
GET/v1/lists/{listId}/accounts
List contacts in a list
GET/v1/lists/{listId}/contacts
List opportunities in a list
GET/v1/lists/{listId}/opportunities

Meeting

Meetings represent synced or manually created interactions in Lightfield. Read responses are privacy-aware and may be redacted based on the caller. For transcript uploads and attachment flows, see Uploading meeting transcripts.

Create a meeting
POST/v1/meetings
Update a meeting
POST/v1/meetings/{id}
Retrieve a meeting
GET/v1/meetings/{id}
List meetings
GET/v1/meetings

Note

Notes represent free-form text records in Lightfield. Each note can be associated with zero or more accounts and opportunities.

Create a note
POST/v1/notes
Update a note
POST/v1/notes/{id}
Retrieve a note
GET/v1/notes/{id}
List notes
GET/v1/notes

Opportunity

Opportunities represent potential deals or sales in Lightfield. Each opportunity belongs to an account and can have tasks and notes associated with it.

Get opportunity field definitions
GET/v1/opportunities/definitions
Create an opportunity
POST/v1/opportunities
Update an opportunity
POST/v1/opportunities/{id}
Retrieve an opportunity
GET/v1/opportunities/{id}
List opportunities
GET/v1/opportunities

Task

Tasks represent action items in Lightfield. Each task belongs to an account, is assigned to a member, and can optionally be associated with an opportunity.

Get task field definitions
GET/v1/tasks/definitions
Create a task
POST/v1/tasks
Update a task
POST/v1/tasks/{id}
Retrieve a task
GET/v1/tasks/{id}
List tasks
GET/v1/tasks

Member

Members represent users in your Lightfield workspace. Members can own accounts and opportunities, and are referenced in relationships like $owner and $createdBy.

Retrieve a member
GET/v1/members/{id}
List members
GET/v1/members

Workflow Run

Workflow runs represent executions of automated workflows.

Get workflow run status
GET/v1/workflowRun/{runId}/status

File

Files are used to upload documents via presigned URLs. After uploading and completing a file, link it to resources through their own APIs (e.g. attach a transcript to a meeting). See File uploads for the full upload flow and supported purposes. For meeting transcript attachments, see Uploading meeting transcripts.

Complete a file upload
POST/v1/files/{id}/complete
Retrieve a file
GET/v1/files/{id}
List files
GET/v1/files
Get a file download URL
GET/v1/files/{id}/url
Cancel a file upload
POST/v1/files/{id}/cancel