> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/lightfield-crm.md).

# Lightfield CRM

Lightfield is a modern CRM platform. Manage accounts, contacts, opportunities, meetings, tasks, notes, lists, and files.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector      | Authentication |
| -------------- | -------------- |
| Lightfield CRM | API Key        |

#### Lightfield CRM

Connect to Lightfield CRM using an API key.

**Set up in Lightfield CRM**

1. Sign in to Lightfield (lightfield.app) with an admin account.
2. Open Settings and go to the API keys section.
3. Create a new API key, selecting the scopes your workflow needs, then copy the key (it has the format sk\_lf\_...).

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Lightfield CRM**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                      |
| ------------- | -------- | -------------------------------------------------- |
| API Key       | Yes      | Your Lightfield API key (starts with sk\_lf\_...). |

**Provider documentation:** [Setup reference](https://docs.lightfield.app/).

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **Lightfield CRM** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### Create Account

Create a new account in Lightfield CRM.

**Required permissions:** `accounts:create`.

**Inputs**

| Field             | Type            | Required | Description                                                                 |
| ----------------- | --------------- | -------- | --------------------------------------------------------------------------- |
| Account Name      | string          | Yes      | The name of the account.                                                    |
| Website           | string          | No       | The website URL of the account.                                             |
| Industry          | select (string) | No       | The industry of the account. Options load from the selected connection.     |
| Headcount         | select (string) | No       | The company headcount. Options load from the selected connection.           |
| LinkedIn          | string          | No       | The account's LinkedIn URL.                                                 |
| Twitter           | string          | No       | The account's Twitter handle.                                               |
| Facebook          | string          | No       | The account's Facebook URL.                                                 |
| Instagram         | string          | No       | The account's Instagram handle.                                             |
| Last Funding Type | select (string) | No       | The account's last funding type. Options load from the selected connection. |
| Custom Fields     | object          | No       | Additional custom fields to set on the account.                             |
| Relationships     | object          | No       | Relationships to associate with this account.                               |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Account ID    | string | The created account's ID.               |
| Account Name  | string | The account name.                       |
| Created At    | string | When the account was created.           |
| Fields        | dict   | The account's field values.             |
| Link          | string | Link to view the account in Lightfield. |
| Relationships | dict   | The account's relationships.            |

#### Get Account

Retrieve an account from Lightfield CRM by ID.

**Required permissions:** `accounts:read`.

**Inputs**

| Field   | Type            | Required | Description                                                         |
| ------- | --------------- | -------- | ------------------------------------------------------------------- |
| Account | select (string) | Yes      | The account to retrieve. Options load from the selected connection. |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Account ID    | string | The account's ID.                       |
| Account Name  | string | The account name.                       |
| Created At    | string | When the account was created.           |
| Fields        | dict   | The account's field values.             |
| Link          | string | Link to view the account in Lightfield. |
| Relationships | dict   | The account's relationships.            |

#### Update Account

Update an existing account in Lightfield CRM.

**Required permissions:** `accounts:update`.

**Inputs**

| Field             | Type            | Required | Description                                                                 |
| ----------------- | --------------- | -------- | --------------------------------------------------------------------------- |
| Account           | select (string) | Yes      | The account to update. Options load from the selected connection.           |
| Account Name      | string          | No       | The name of the account.                                                    |
| Website           | string          | No       | The website URL of the account.                                             |
| Industry          | select (string) | No       | The industry of the account. Options load from the selected connection.     |
| Headcount         | select (string) | No       | The company headcount. Options load from the selected connection.           |
| LinkedIn          | string          | No       | The account's LinkedIn URL.                                                 |
| Twitter           | string          | No       | The account's Twitter handle.                                               |
| Facebook          | string          | No       | The account's Facebook URL.                                                 |
| Instagram         | string          | No       | The account's Instagram handle.                                             |
| Last Funding Type | select (string) | No       | The account's last funding type. Options load from the selected connection. |
| Custom Fields     | object          | No       | Additional custom fields to update on the account.                          |
| Relationships     | object          | No       | Relationships to update on this account.                                    |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Account ID    | string | The account's ID.                       |
| Account Name  | string | The account name.                       |
| Created At    | string | When the account was created.           |
| Fields        | dict   | The account's field values.             |
| Link          | string | Link to view the account in Lightfield. |
| Relationships | dict   | The account's relationships.            |

#### List Accounts

List accounts from Lightfield CRM.

**Required permissions:** `accounts:read`.

**Inputs**

| Field  | Type    | Required | Description                           |
| ------ | ------- | -------- | ------------------------------------- |
| Limit  | integer | No       | Maximum number of accounts to return. |
| Offset | integer | No       | Number of accounts to skip.           |

**Outputs**

| Field       | Type        | Description               |
| ----------- | ----------- | ------------------------- |
| Accounts    | dict\_array | The list of accounts.     |
| Total Count | integer     | Total number of accounts. |

#### Get Account Definitions

Get available field and relationship definitions for Lightfield accounts.

**Required permissions:** `accounts:read`.

**Inputs**

No input fields are required in this catalog entry.

**Outputs**

| Field                    | Type   | Description                                      |
| ------------------------ | ------ | ------------------------------------------------ |
| Object Type              | string | The object type.                                 |
| Field Definitions        | dict   | Available field definitions for accounts.        |
| Relationship Definitions | dict   | Available relationship definitions for accounts. |

#### Create Contact

Create a new contact in Lightfield CRM.

**Required permissions:** `contacts:create`.

**Inputs**

| Field             | Type   | Required | Description                                     |
| ----------------- | ------ | -------- | ----------------------------------------------- |
| First Name        | string | No       | The contact's first name.                       |
| Last Name         | string | No       | The contact's last name.                        |
| Email             | string | No       | The contact's email address.                    |
| Job Title         | string | No       | The contact's job title.                        |
| Department        | string | No       | The contact's department.                       |
| Phone             | string | No       | The contact's phone number.                     |
| LinkedIn          | string | No       | The contact's LinkedIn URL.                     |
| Twitter           | string | No       | The contact's Twitter handle.                   |
| Facebook          | string | No       | The contact's Facebook URL.                     |
| Instagram         | string | No       | The contact's Instagram handle.                 |
| Notes             | string | No       | Notes about the contact.                        |
| Profile Photo URL | string | No       | URL to the contact's profile photo.             |
| Custom Fields     | object | No       | Additional custom fields to set on the contact. |
| Relationships     | object | No       | Relationships to associate with this contact.   |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Contact ID    | string | The created contact's ID.               |
| Contact Name  | string | The contact name.                       |
| Created At    | string | When the contact was created.           |
| Fields        | dict   | The contact's field values.             |
| Link          | string | Link to view the contact in Lightfield. |
| Relationships | dict   | The contact's relationships.            |

#### Get Contact

Retrieve a contact from Lightfield CRM by ID.

**Required permissions:** `contacts:read`.

**Inputs**

| Field   | Type            | Required | Description                                                         |
| ------- | --------------- | -------- | ------------------------------------------------------------------- |
| Contact | select (string) | Yes      | The contact to retrieve. Options load from the selected connection. |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Contact ID    | string | The contact's ID.                       |
| Contact Name  | string | The contact name.                       |
| Created At    | string | When the contact was created.           |
| Fields        | dict   | The contact's field values.             |
| Link          | string | Link to view the contact in Lightfield. |
| Relationships | dict   | The contact's relationships.            |

#### Update Contact

Update an existing contact in Lightfield CRM.

**Required permissions:** `contacts:update`.

**Inputs**

| Field             | Type            | Required | Description                                                       |
| ----------------- | --------------- | -------- | ----------------------------------------------------------------- |
| Contact           | select (string) | Yes      | The contact to update. Options load from the selected connection. |
| First Name        | string          | No       | The contact's first name.                                         |
| Last Name         | string          | No       | The contact's last name.                                          |
| Email             | string          | No       | The contact's email address.                                      |
| Job Title         | string          | No       | The contact's job title.                                          |
| Department        | string          | No       | The contact's department.                                         |
| Phone             | string          | No       | The contact's phone number.                                       |
| LinkedIn          | string          | No       | The contact's LinkedIn URL.                                       |
| Twitter           | string          | No       | The contact's Twitter handle.                                     |
| Facebook          | string          | No       | The contact's Facebook URL.                                       |
| Instagram         | string          | No       | The contact's Instagram handle.                                   |
| Notes             | string          | No       | Notes about the contact.                                          |
| Profile Photo URL | string          | No       | URL to the contact's profile photo.                               |
| Custom Fields     | object          | No       | Additional custom fields to update on the contact.                |
| Relationships     | object          | No       | Relationships to update on this contact.                          |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Contact ID    | string | The contact's ID.                       |
| Contact Name  | string | The contact name.                       |
| Created At    | string | When the contact was created.           |
| Fields        | dict   | The contact's field values.             |
| Link          | string | Link to view the contact in Lightfield. |
| Relationships | dict   | The contact's relationships.            |

#### List Contacts

List contacts from Lightfield CRM.

**Required permissions:** `contacts:read`.

**Inputs**

| Field  | Type    | Required | Description                           |
| ------ | ------- | -------- | ------------------------------------- |
| Limit  | integer | No       | Maximum number of contacts to return. |
| Offset | integer | No       | Number of contacts to skip.           |

**Outputs**

| Field       | Type        | Description               |
| ----------- | ----------- | ------------------------- |
| Contacts    | dict\_array | The list of contacts.     |
| Total Count | integer     | Total number of contacts. |

#### Get Contact Definitions

Get available field and relationship definitions for Lightfield contacts.

**Required permissions:** `contacts:read`.

**Inputs**

No input fields are required in this catalog entry.

**Outputs**

| Field                    | Type   | Description                                      |
| ------------------------ | ------ | ------------------------------------------------ |
| Object Type              | string | The object type.                                 |
| Field Definitions        | dict   | Available field definitions for contacts.        |
| Relationship Definitions | dict   | Available relationship definitions for contacts. |

#### Create Opportunity

Create a new opportunity in Lightfield CRM.

**Required permissions:** `opportunities:create`.

**Inputs**

| Field                    | Type            | Required | Description                                                                                |
| ------------------------ | --------------- | -------- | ------------------------------------------------------------------------------------------ |
| Opportunity Name         | string          | Yes      | The name of the opportunity.                                                               |
| Stage                    | select (string) | Yes      | Select the pipeline stage for this opportunity. Options load from the selected connection. |
| Account ID               | string          | Yes      | The account (company) this opportunity belongs to.                                         |
| Owner                    | string          | No       | The workspace member who owns this opportunity.                                            |
| Champion                 | string          | No       | The contact who champions this opportunity internally.                                     |
| Evaluator                | string          | No       | The contact evaluating this opportunity.                                                   |
| Custom Fields            | object          | No       | Additional custom fields to set on the opportunity.                                        |
| Additional Relationships | object          | No       | Additional relationships to set on the opportunity.                                        |

**Outputs**

| Field            | Type   | Description                                 |
| ---------------- | ------ | ------------------------------------------- |
| Opportunity ID   | string | The created opportunity's ID.               |
| Opportunity Name | string | The opportunity name.                       |
| Created At       | string | When the opportunity was created.           |
| Fields           | dict   | The opportunity's field values.             |
| Link             | string | Link to view the opportunity in Lightfield. |
| Relationships    | dict   | The opportunity's relationships.            |

#### Get Opportunity

Retrieve an opportunity from Lightfield CRM by ID.

**Required permissions:** `opportunities:read`.

**Inputs**

| Field       | Type            | Required | Description                                                             |
| ----------- | --------------- | -------- | ----------------------------------------------------------------------- |
| Opportunity | select (string) | Yes      | The opportunity to retrieve. Options load from the selected connection. |

**Outputs**

| Field            | Type   | Description                                 |
| ---------------- | ------ | ------------------------------------------- |
| Opportunity ID   | string | The opportunity's ID.                       |
| Opportunity Name | string | The opportunity name.                       |
| Created At       | string | When the opportunity was created.           |
| Fields           | dict   | The opportunity's field values.             |
| Link             | string | Link to view the opportunity in Lightfield. |
| Relationships    | dict   | The opportunity's relationships.            |

#### Update Opportunity

Update an existing opportunity in Lightfield CRM.

**Required permissions:** `opportunities:update`.

**Inputs**

| Field                    | Type            | Required | Description                                                                                |
| ------------------------ | --------------- | -------- | ------------------------------------------------------------------------------------------ |
| Opportunity              | select (string) | Yes      | The opportunity to update. Options load from the selected connection.                      |
| Opportunity Name         | string          | No       | The name of the opportunity.                                                               |
| Stage                    | select (string) | No       | Select the pipeline stage for this opportunity. Options load from the selected connection. |
| Owner                    | string          | No       | The workspace member who owns this opportunity. Replaces current owner.                    |
| Champion                 | string          | No       | The contact who champions this opportunity. Replaces current.                              |
| Evaluator                | string          | No       | The contact evaluating this opportunity. Replaces current.                                 |
| Custom Fields            | object          | No       | Additional custom fields to update on the opportunity.                                     |
| Additional Relationships | object          | No       | Additional relationships to update on this opportunity.                                    |

**Outputs**

| Field            | Type   | Description                                 |
| ---------------- | ------ | ------------------------------------------- |
| Opportunity ID   | string | The opportunity's ID.                       |
| Opportunity Name | string | The opportunity name.                       |
| Created At       | string | When the opportunity was created.           |
| Fields           | dict   | The opportunity's field values.             |
| Link             | string | Link to view the opportunity in Lightfield. |
| Relationships    | dict   | The opportunity's relationships.            |

#### List Opportunities

List opportunities from Lightfield CRM.

**Required permissions:** `opportunities:read`.

**Inputs**

| Field  | Type    | Required | Description                                |
| ------ | ------- | -------- | ------------------------------------------ |
| Limit  | integer | No       | Maximum number of opportunities to return. |
| Offset | integer | No       | Number of opportunities to skip.           |

**Outputs**

| Field         | Type        | Description                    |
| ------------- | ----------- | ------------------------------ |
| Opportunities | dict\_array | The list of opportunities.     |
| Total Count   | integer     | Total number of opportunities. |

#### Get Opportunity Definitions

Get available field and relationship definitions for Lightfield opportunities.

**Required permissions:** `opportunities:read`.

**Inputs**

No input fields are required in this catalog entry.

**Outputs**

| Field                    | Type   | Description                                           |
| ------------------------ | ------ | ----------------------------------------------------- |
| Object Type              | string | The object type.                                      |
| Field Definitions        | dict   | Available field definitions for opportunities.        |
| Relationship Definitions | dict   | Available relationship definitions for opportunities. |

#### Get Member

Retrieve a workspace member from Lightfield by ID.

**Required permissions:** `members:read`.

**Inputs**

| Field  | Type            | Required | Description                                                        |
| ------ | --------------- | -------- | ------------------------------------------------------------------ |
| Member | select (string) | Yes      | The member to retrieve. Options load from the selected connection. |

**Outputs**

| Field       | Type   | Description                            |
| ----------- | ------ | -------------------------------------- |
| Member ID   | string | The member's ID.                       |
| Member Name | string | The member name.                       |
| Created At  | string | When the member was created.           |
| Fields      | dict   | The member's field values.             |
| Link        | string | Link to view the member in Lightfield. |

#### List Members

List workspace members from Lightfield.

**Required permissions:** `members:read`.

**Inputs**

| Field  | Type    | Required | Description                          |
| ------ | ------- | -------- | ------------------------------------ |
| Limit  | integer | No       | Maximum number of members to return. |
| Offset | integer | No       | Number of members to skip.           |

**Outputs**

| Field       | Type        | Description              |
| ----------- | ----------- | ------------------------ |
| Members     | dict\_array | The list of members.     |
| Total Count | integer     | Total number of members. |

#### Create Meeting

Log a past meeting in Lightfield CRM.

**Required permissions:** `meetings:create`.

**Inputs**

| Field               | Type            | Required | Description                                                                                                                                                                  |
| ------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Meeting Title       | string          | Yes      | The title of the meeting.                                                                                                                                                    |
| Start Date          | string          | Yes      | When the meeting started (must be in the past).                                                                                                                              |
| End Date            | string          | Yes      | When the meeting ended (must be in the past).                                                                                                                                |
| Description         | textarea        | No       | A description of the meeting.                                                                                                                                                |
| Organizer Email     | string          | No       | The organizer's email address.                                                                                                                                               |
| Attendee Emails     | string          | No       | Comma-separated attendee email addresses.                                                                                                                                    |
| Meeting URL         | string          | No       | Meeting link (Zoom, Google Meet, etc.).                                                                                                                                      |
| Privacy Setting     | select (string) | No       | Controls who can see full meeting details vs. basic info. Available values: Full — All attendees see full meeting details, Metadata — Attendees only see basic meeting info. |
| Auto-Create Records | boolean         | No       | Automatically create account/contact records for external attendees.                                                                                                         |
| Transcript File     | select (string) | No       | The transcript file to attach to the meeting. Options load from the selected connection.                                                                                     |
| Custom Fields       | object          | No       | Additional custom fields to set on the meeting.                                                                                                                              |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Meeting ID    | string | The created meeting's ID.               |
| Meeting Title | string | The meeting title.                      |
| Created At    | string | When the meeting was created.           |
| Updated At    | string | When the meeting was last updated.      |
| Access Level  | string | Your access level for this meeting.     |
| Object Type   | string | The object type.                        |
| Fields        | dict   | The meeting's field values.             |
| Link          | string | Link to view the meeting in Lightfield. |
| Relationships | dict   | The meeting's relationships.            |

#### Get Meeting

Retrieve a meeting from Lightfield CRM by ID.

**Required permissions:** `meetings:read`.

**Inputs**

| Field   | Type            | Required | Description                                                         |
| ------- | --------------- | -------- | ------------------------------------------------------------------- |
| Meeting | select (string) | Yes      | The meeting to retrieve. Options load from the selected connection. |

**Outputs**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| Meeting ID    | string | The meeting's ID.                       |
| Meeting Title | string | The meeting title.                      |
| Created At    | string | When the meeting was created.           |
| Updated At    | string | When the meeting was last updated.      |
| Access Level  | string | Your access level for this meeting.     |
| Object Type   | string | The object type.                        |
| Fields        | dict   | The meeting's field values.             |
| Link          | string | Link to view the meeting in Lightfield. |
| Relationships | dict   | The meeting's relationships.            |

#### List Meetings

List meetings from Lightfield CRM.

**Required permissions:** `meetings:read`.

**Inputs**

| Field  | Type    | Required | Description                   |
| ------ | ------- | -------- | ----------------------------- |
| Limit  | integer | No       | Max meetings per page (1-25). |
| Offset | integer | No       | Number of meetings to skip.   |

**Outputs**

| Field       | Type          | Description               |
| ----------- | ------------- | ------------------------- |
| Meetings    | object\_array | The list of meetings.     |
| Total Count | integer       | Total number of meetings. |

#### Get Meeting Transcript

Get the transcript and download URL for a Lightfield meeting.

**Required permissions:** `meetings:read`, `files:read`.

**Inputs**

| Field   | Type            | Required | Description                                                                          |
| ------- | --------------- | -------- | ------------------------------------------------------------------------------------ |
| Meeting | select (string) | Yes      | The meeting whose transcript to retrieve. Options load from the selected connection. |

**Outputs**

| Field               | Type   | Description                               |
| ------------------- | ------ | ----------------------------------------- |
| Meeting ID          | string | The meeting ID.                           |
| Meeting Title       | string | The meeting title.                        |
| Transcript File ID  | string | The transcript's file ID.                 |
| Transcript Filename | string | The transcript filename.                  |
| Transcript Content  | string | The transcript text content.              |
| Download URL        | string | Temporary URL to download the transcript. |
| File Details        | dict   | Transcript file details.                  |

#### Create Task

Create a new task in Lightfield CRM.

**Required permissions:** `tasks:create`.

**Inputs**

| Field         | Type            | Required | Description                                                                         |
| ------------- | --------------- | -------- | ----------------------------------------------------------------------------------- |
| Title         | string          | Yes      | The title of the task.                                                              |
| Status        | select (string) | Yes      | The status of the task. Options load from the selected connection.                  |
| Assigned To   | select (string) | Yes      | Member to assign this task to. Options load from the selected connection.           |
| Description   | textarea        | No       | The description of the task.                                                        |
| Due At        | string          | No       | The due date of the task.                                                           |
| Account       | select (string) | No       | Account to associate with this task. Options load from the selected connection.     |
| Opportunity   | select (string) | No       | Opportunity to associate with this task. Options load from the selected connection. |
| Custom Fields | object          | No       | Additional custom fields to set on the task.                                        |
| Relationships | object          | No       | Additional relationships to associate with this task.                               |

**Outputs**

| Field         | Type   | Description                          |
| ------------- | ------ | ------------------------------------ |
| Task ID       | string | The created task's ID.               |
| Title         | string | The task title.                      |
| Created At    | string | When the task was created.           |
| Updated At    | string | When the task was last updated.      |
| Fields        | dict   | The task's field values.             |
| Link          | string | Link to view the task in Lightfield. |
| Relationships | dict   | The task's relationships.            |

#### Get Task

Retrieve a task from Lightfield CRM by ID.

**Required permissions:** `tasks:read`.

**Inputs**

| Field | Type            | Required | Description                                                      |
| ----- | --------------- | -------- | ---------------------------------------------------------------- |
| Task  | select (string) | Yes      | The task to retrieve. Options load from the selected connection. |

**Outputs**

| Field         | Type   | Description                          |
| ------------- | ------ | ------------------------------------ |
| Task ID       | string | The task's ID.                       |
| Title         | string | The task title.                      |
| Status        | string | The task status.                     |
| Created At    | string | When the task was created.           |
| Updated At    | string | When the task was last updated.      |
| Fields        | dict   | The task's field values.             |
| Link          | string | Link to view the task in Lightfield. |
| Relationships | dict   | The task's relationships.            |

#### Update Task

Update an existing task in Lightfield CRM.

**Required permissions:** `tasks:update`.

**Inputs**

| Field         | Type            | Required | Description                                                                         |
| ------------- | --------------- | -------- | ----------------------------------------------------------------------------------- |
| Task          | select (string) | Yes      | The task to update. Options load from the selected connection.                      |
| Title         | string          | No       | The title of the task.                                                              |
| Description   | textarea        | No       | The description of the task.                                                        |
| Due At        | string          | No       | The due date of the task.                                                           |
| Status        | select (string) | No       | The status of the task. Options load from the selected connection.                  |
| Assigned To   | select (string) | No       | Member to assign this task to. Options load from the selected connection.           |
| Account       | select (string) | No       | Account to associate with this task. Options load from the selected connection.     |
| Opportunity   | select (string) | No       | Opportunity to associate with this task. Options load from the selected connection. |
| Custom Fields | object          | No       | Additional custom fields to update on the task.                                     |
| Relationships | object          | No       | Relationships to update on this task.                                               |

**Outputs**

| Field         | Type   | Description                          |
| ------------- | ------ | ------------------------------------ |
| Task ID       | string | The task's ID.                       |
| Title         | string | The task title.                      |
| Created At    | string | When the task was created.           |
| Updated At    | string | When the task was last updated.      |
| Fields        | dict   | The task's field values.             |
| Link          | string | Link to view the task in Lightfield. |
| Relationships | dict   | The task's relationships.            |

#### List Tasks

List tasks from Lightfield CRM.

**Required permissions:** `tasks:read`.

**Inputs**

| Field  | Type    | Required | Description                        |
| ------ | ------- | -------- | ---------------------------------- |
| Limit  | integer | No       | Maximum number of tasks to return. |
| Offset | integer | No       | Number of tasks to skip.           |

**Outputs**

| Field       | Type        | Description            |
| ----------- | ----------- | ---------------------- |
| Tasks       | dict\_array | The list of tasks.     |
| Total Count | integer     | Total number of tasks. |

#### Get Task Definitions

Get available field and relationship definitions for Lightfield tasks.

**Required permissions:** `tasks:read`.

**Inputs**

No input fields are required in this catalog entry.

**Outputs**

| Field                    | Type   | Description                                   |
| ------------------------ | ------ | --------------------------------------------- |
| Object Type              | string | The object type.                              |
| Field Definitions        | dict   | Available field definitions for tasks.        |
| Relationship Definitions | dict   | Available relationship definitions for tasks. |

#### Create Note

Create a note in Lightfield CRM.

**Required permissions:** `notes:create`.

**Inputs**

| Field         | Type            | Required | Description                                                                         |
| ------------- | --------------- | -------- | ----------------------------------------------------------------------------------- |
| Title         | string          | Yes      | The title of the note.                                                              |
| Content       | textarea        | No       | Note content in markdown format.                                                    |
| Account       | select (string) | No       | Account to associate with this note. Options load from the selected connection.     |
| Opportunity   | select (string) | No       | Opportunity to associate with this note. Options load from the selected connection. |
| Custom Fields | object          | No       | Additional custom fields to set on the note.                                        |
| Relationships | object          | No       | Relationships to associate with this note.                                          |

**Outputs**

| Field         | Type   | Description                          |
| ------------- | ------ | ------------------------------------ |
| Note ID       | string | The created note's ID.               |
| Note Title    | string | The note title.                      |
| Created At    | string | When the note was created.           |
| Updated At    | string | When the note was last updated.      |
| Fields        | dict   | The note's field values.             |
| Link          | string | Link to view the note in Lightfield. |
| Relationships | dict   | The note's relationships.            |

#### Get Note

Retrieve a note from Lightfield CRM by ID.

**Required permissions:** `notes:read`.

**Inputs**

| Field | Type            | Required | Description                                                      |
| ----- | --------------- | -------- | ---------------------------------------------------------------- |
| Note  | select (string) | Yes      | The note to retrieve. Options load from the selected connection. |

**Outputs**

| Field         | Type   | Description                          |
| ------------- | ------ | ------------------------------------ |
| Note ID       | string | The note's ID.                       |
| Note Title    | string | The note title.                      |
| Created At    | string | When the note was created.           |
| Updated At    | string | When the note was last updated.      |
| Fields        | dict   | The note's field values.             |
| Link          | string | Link to view the note in Lightfield. |
| Relationships | dict   | The note's relationships.            |

#### Update Note

Update a note in Lightfield CRM. Title, content, and relationships can be modified.

**Required permissions:** `notes:update`.

**Inputs**

| Field         | Type            | Required | Description                                                    |
| ------------- | --------------- | -------- | -------------------------------------------------------------- |
| Note          | select (string) | Yes      | The note to update. Options load from the selected connection. |
| Title         | string          | No       | The title of the note.                                         |
| Content       | textarea        | No       | Note content in markdown format.                               |
| Custom Fields | object          | No       | Additional custom fields to update on the note.                |
| Relationships | object          | No       | Relationships to update on this note.                          |

**Outputs**

| Field         | Type   | Description                          |
| ------------- | ------ | ------------------------------------ |
| Note ID       | string | The updated note's ID.               |
| Note Title    | string | The note title.                      |
| Created At    | string | When the note was created.           |
| Updated At    | string | When the note was last updated.      |
| Fields        | dict   | The note's field values.             |
| Link          | string | Link to view the note in Lightfield. |
| Relationships | dict   | The note's relationships.            |

#### List Notes

List notes from Lightfield CRM.

**Required permissions:** `notes:read`.

**Inputs**

| Field  | Type    | Required | Description                        |
| ------ | ------- | -------- | ---------------------------------- |
| Limit  | integer | No       | Maximum number of notes to return. |
| Offset | integer | No       | Number of notes to skip.           |

**Outputs**

| Field       | Type        | Description            |
| ----------- | ----------- | ---------------------- |
| Notes       | dict\_array | The list of notes.     |
| Total Count | integer     | Total number of notes. |

#### Create List

Create a new list in Lightfield CRM.

**Required permissions:** `lists:create`.

**Inputs**

| Field         | Type            | Required | Description                                                                                  |
| ------------- | --------------- | -------- | -------------------------------------------------------------------------------------------- |
| List Name     | string          | Yes      | The name of the list.                                                                        |
| Object Type   | select (string) | Yes      | The type of objects this list will contain. Available values: Account, Contact, Opportunity. |
| Member IDs    | string          | No       | Comma-separated IDs of initial members to add.                                               |
| Relationships | object          | No       | Additional relationships to associate with this list.                                        |

**Outputs**

| Field      | Type   | Description                          |
| ---------- | ------ | ------------------------------------ |
| List ID    | string | The created list's ID.               |
| List Name  | string | The list name.                       |
| Created At | string | When the list was created.           |
| Fields     | dict   | The list's field values.             |
| Link       | string | Link to view the list in Lightfield. |

#### Get List

Retrieve a list from Lightfield CRM by ID.

**Required permissions:** `lists:read`.

**Inputs**

| Field | Type            | Required | Description                                                      |
| ----- | --------------- | -------- | ---------------------------------------------------------------- |
| List  | select (string) | Yes      | The list to retrieve. Options load from the selected connection. |

**Outputs**

| Field      | Type   | Description                          |
| ---------- | ------ | ------------------------------------ |
| List ID    | string | The list's ID.                       |
| List Name  | string | The list name.                       |
| Created At | string | When the list was created.           |
| Fields     | dict   | The list's field values.             |
| Link       | string | Link to view the list in Lightfield. |

#### Update List

Update an existing list in Lightfield CRM.

**Required permissions:** `lists:update`.

**Inputs**

| Field              | Type            | Required | Description                                                                                                                  |
| ------------------ | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| List               | select (string) | Yes      | The list to update. Options load from the selected connection.                                                               |
| List Name          | string          | No       | New name for the list.                                                                                                       |
| Member Object Type | select (string) | No       | The type of objects in this list. Required when adding or removing members. Available values: Account, Contact, Opportunity. |
| Add Member IDs     | string          | No       | Comma-separated IDs of members to add to the list.                                                                           |
| Remove Member IDs  | string          | No       | Comma-separated IDs of members to remove from the list.                                                                      |
| Relationships      | object          | No       | Additional relationships to set on the list.                                                                                 |

**Outputs**

| Field      | Type   | Description                          |
| ---------- | ------ | ------------------------------------ |
| List ID    | string | The updated list's ID.               |
| List Name  | string | The list name.                       |
| Created At | string | When the list was created.           |
| Fields     | dict   | The list's field values.             |
| Link       | string | Link to view the list in Lightfield. |

#### List Lists

List lists from Lightfield CRM.

**Required permissions:** `lists:read`.

**Inputs**

| Field  | Type    | Required | Description                        |
| ------ | ------- | -------- | ---------------------------------- |
| Limit  | integer | No       | Maximum number of lists to return. |
| Offset | integer | No       | Number of lists to skip.           |

**Outputs**

| Field       | Type        | Description            |
| ----------- | ----------- | ---------------------- |
| Lists       | dict\_array | The lists.             |
| Total Count | integer     | Total number of lists. |

#### List Accounts in List

List accounts belonging to a specific list in Lightfield CRM.

**Required permissions:** `lists:read`.

**Inputs**

| Field  | Type            | Required | Description                                                                    |
| ------ | --------------- | -------- | ------------------------------------------------------------------------------ |
| List   | select (string) | Yes      | The list to retrieve accounts from. Options load from the selected connection. |
| Limit  | integer         | No       | Maximum number of accounts to return.                                          |
| Offset | integer         | No       | Number of accounts to skip.                                                    |

**Outputs**

| Field       | Type        | Description               |
| ----------- | ----------- | ------------------------- |
| Accounts    | dict\_array | The list of accounts.     |
| Total Count | integer     | Total number of accounts. |

#### List Contacts in List

List contacts belonging to a specific list in Lightfield CRM.

**Required permissions:** `lists:read`.

**Inputs**

| Field  | Type            | Required | Description                                                                    |
| ------ | --------------- | -------- | ------------------------------------------------------------------------------ |
| List   | select (string) | Yes      | The list to retrieve contacts from. Options load from the selected connection. |
| Limit  | integer         | No       | Maximum number of contacts to return.                                          |
| Offset | integer         | No       | Number of contacts to skip.                                                    |

**Outputs**

| Field       | Type        | Description               |
| ----------- | ----------- | ------------------------- |
| Contacts    | dict\_array | The list of contacts.     |
| Total Count | integer     | Total number of contacts. |

#### List Opportunities in List

List opportunities belonging to a specific list in Lightfield CRM.

**Required permissions:** `lists:read`.

**Inputs**

| Field  | Type            | Required | Description                                                                         |
| ------ | --------------- | -------- | ----------------------------------------------------------------------------------- |
| List   | select (string) | Yes      | The list to retrieve opportunities from. Options load from the selected connection. |
| Limit  | integer         | No       | Maximum number of opportunities to return.                                          |
| Offset | integer         | No       | Number of opportunities to skip.                                                    |

**Outputs**

| Field         | Type        | Description                    |
| ------------- | ----------- | ------------------------------ |
| Opportunities | dict\_array | The list of opportunities.     |
| Total Count   | integer     | Total number of opportunities. |

#### Get File

Retrieve a file from Lightfield by ID.

**Required permissions:** `files:read`.

**Inputs**

| Field | Type            | Required | Description                                                      |
| ----- | --------------- | -------- | ---------------------------------------------------------------- |
| File  | select (string) | Yes      | The file to retrieve. Options load from the selected connection. |

**Outputs**

| Field        | Type    | Description                          |
| ------------ | ------- | ------------------------------------ |
| File ID      | string  | The file's ID.                       |
| Filename     | string  | The filename.                        |
| MIME Type    | string  | The file's MIME type.                |
| Size (bytes) | integer | The file size in bytes.              |
| Status       | string  | The file's current status.           |
| Created At   | string  | When the upload session was created. |
| Completed At | string  | When the upload was completed.       |
| Expires At   | string  | When the upload session expires.     |

#### List Files

List files from Lightfield.

**Required permissions:** `files:read`.

**Inputs**

| Field  | Type    | Required | Description                |
| ------ | ------- | -------- | -------------------------- |
| Limit  | integer | No       | Max files per page (1-25). |
| Offset | integer | No       | Number of files to skip.   |

**Outputs**

| Field       | Type          | Description            |
| ----------- | ------------- | ---------------------- |
| Files       | object\_array | The list of files.     |
| Total Count | integer       | Total number of files. |

#### Get File Download URL

Get a temporary download URL for a Lightfield file.

**Required permissions:** `files:read`.

**Inputs**

| Field | Type            | Required | Description                                                                    |
| ----- | --------------- | -------- | ------------------------------------------------------------------------------ |
| File  | select (string) | Yes      | The file to get a download URL for. Options load from the selected connection. |

**Outputs**

| Field        | Type   | Description                          |
| ------------ | ------ | ------------------------------------ |
| Download URL | string | Temporary download URL for the file. |
| Expires At   | string | When the download URL expires.       |

#### Get Workflow Run Status

Check the status of a Lightfield workflow run.

**Inputs**

| Field           | Type   | Required | Description                 |
| --------------- | ------ | -------- | --------------------------- |
| Workflow Run ID | string | Yes      | The ID of the workflow run. |

**Outputs**

| Field  | Type   | Description                        |
| ------ | ------ | ---------------------------------- |
| Status | string | The workflow run's current status. |

### Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/lightfield-crm.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
