> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Expensify

> How to set up the Expensify connector, plus the actions that are available.

<div className="connector-page-header">
  <img src="https://stackone-logos.com/api/expensify/filled/svg" alt="Expensify" className="connector-page-icon" />

  <div className="connector-page-changelog">
    <div className="connector-page-version"><span>v1.2.1</span></div>
    <div><a href="/connectors/expensify/changelog">See changelog</a></div>
  </div>

  <div className="connector-page-header-meta">
    <div className="connector-page-subtitle"><a href="#actions">27 actions</a> · 1 auth method</div>

    <div className="connector-page-category-tags">
      <span className="connector-page-category-tag">Expense Management</span>
      <span className="connector-page-category-tag">IAM</span>
    </div>
  </div>
</div>

## Getting Started

<Steps>
  <Step title="Create or Select a Project">
    Set up a new project or select an existing one. See [Organizations & Projects](/gateway/concepts/organizations-and-projects).
  </Step>

  <Step title="Configure the Connector">
    Enable the connector and set up a Connector Profile in your project. See [Setup Connector Profile](/gateway/quickstart#setup-connector-profile).

    <Columns cols={2}>
      <Card title="Connector Profile · Partner User ID and Secret" href="/connectors/expensify/guides/connector-profile/partner-user-id-and-secret" icon="https://stackone-logos.com/api/expensify/filled/svg" horizontal>
        Uses a Partner User ID and Partner User Secret pair generated from the Expensify Integrations page. No app registration...
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Link an account [from the dashboard](/connect/managing-connectors/linking-accounts#link-from-the-dashboard) (or via [StackOne Hub](/embed/account-linking/overview)).

    See the guide for the authentication type chosen in the Connector Profile:

    <Columns cols={2}>
      <Card title="Link Account · Partner User ID and Secret" href="/connectors/expensify/guides/link-account/partner-user-id-and-secret" icon="https://stackone-logos.com/api/expensify/filled/svg" horizontal />
    </Columns>
  </Step>

  <Step title="Use Actions">
    Connect an AI platform to the linked account's actions. See [AI Platforms](/connect/ai-platforms/overview).

    Other ways to call actions are listed in [Protocols & SDKs](/connect/protocols-and-sdks).
  </Step>
</Steps>

## Actions

<div className="connector-meta-library-section">
  <div className="connector-actions-controls not-prose" data-connector-actions-controls>
    <div className="connector-actions-controls__row">
      <input type="search" className="connector-actions-search" data-connector-actions-search placeholder="Search actions" aria-label="Search actions" />
    </div>
  </div>

  <div className="meta-library-count" data-connector-actions-count>27 actions</div>

  <div className="not-prose meta-library-table-container" data-connector-actions-table>
    <div className="connector-meta-library-grid">
      <div className="connector-meta-library-row">
        <div className="meta-library-grid-header-cell">Action</div>
        <div className="meta-library-grid-header-cell">Description</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_update_employee" data-action-label="Update Employee" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Employee</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_update_employee" aria-label="Copy expensify_update_employee"><code className="connector-page-code">expensify\_update\_employee</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add a new employee to an Expensify policy OR update an existing one (upsert), via the Advanced Employee Updater — sets a...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_list_domain_cards" data-action-label="List Domain Cards" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Domain Cards</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_list_domain_cards" aria-label="Copy expensify_list_domain_cards"><code className="connector-page-code">expensify\_list\_domain\_cards</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve comprehensive inventory of corporate cards configured at domain level with transaction import status and cardho...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_update_tag_approver" data-action-label="Update Tag Approver" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Tag Approver</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_update_tag_approver" aria-label="Copy expensify_update_tag_approver"><code className="connector-page-code">expensify\_update\_tag\_approver</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Configure tag-based approval routing to automatically route expenses with specific tags to designated approvers for depa...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_create_expense" data-action-label="Create Expense" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Expense</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_create_expense" aria-label="Copy expensify_create_expense"><code className="connector-page-code">expensify\_create\_expense</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Programmatically create individual expense transactions in user accounts for automated expense importing from external s...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_create_expense_rule" data-action-label="Create Expense Rule" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Expense Rule</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_create_expense_rule" aria-label="Copy expensify_create_expense_rule"><code className="connector-page-code">expensify\_create\_expense\_rule</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Automate expense classification by creating rules that automatically apply tags to employee expenses based on policy con...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_update_expense_rule" data-action-label="Update Expense Rule" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Expense Rule</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_update_expense_rule" aria-label="Copy expensify_update_expense_rule"><code className="connector-page-code">expensify\_update\_expense\_rule</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update an existing expense rule for a given employee on a policy to modify automatic tag or billable settings</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_export_reconciliation" data-action-label="Export Card Reconciliation" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Export Card Reconciliation</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_export_reconciliation" aria-label="Copy expensify_export_reconciliation"><code className="connector-page-code">expensify\_export\_reconciliation</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Generate comprehensive corporate card reconciliation reports for specified date ranges to compare card transactions with...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_get_me" data-action-label="Get Unified Credentials" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified Credentials</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_get_me" aria-label="Copy expensify_unified_get_me"><code className="connector-page-code">expensify\_unified\_get\_me</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get the current Expensify connection's unified credentials and identity.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_auth_test" data-action-label="IAM Auth Test" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>IAM Auth Test</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_auth_test" aria-label="Copy expensify_auth_test"><code className="connector-page-code">expensify\_auth\_test</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Validate Expensify partner credentials by calling Policy List Getter. Returns the raw, unmapped Expensify response so yo...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_list_organizations" data-action-label="List Unified Organizations" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Organizations</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_list_organizations" aria-label="Copy expensify_unified_list_organizations"><code className="connector-page-code">expensify\_unified\_list\_organizations</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List unified organizations in Expensify.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_get_organization" data-action-label="Get Unified Organization" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified Organization</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_get_organization" aria-label="Copy expensify_unified_get_organization"><code className="connector-page-code">expensify\_unified\_get\_organization</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a unified Expensify organization by ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_list_resource_types" data-action-label="List Unified Resource Types" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Resource Types</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_list_resource_types" aria-label="Copy expensify_unified_list_resource_types"><code className="connector-page-code">expensify\_unified\_list\_resource\_types</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List unified resource types in Expensify.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_list_resource_users" data-action-label="List Unified Resource Users" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Resource Users</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_list_resource_users" aria-label="Copy expensify_unified_list_resource_users"><code className="connector-page-code">expensify\_unified\_list\_resource\_users</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List unified resource users in Expensify.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_list_roles" data-action-label="List Unified Roles" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Roles</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_list_roles" aria-label="Copy expensify_unified_list_roles"><code className="connector-page-code">expensify\_unified\_list\_roles</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List unified roles in Expensify.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_get_role" data-action-label="Get Unified Role" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified Role</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_get_role" aria-label="Copy expensify_unified_get_role"><code className="connector-page-code">expensify\_unified\_get\_role</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a unified Expensify role by ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_list_users" data-action-label="List Unified Users" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Unified Users</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_list_users" aria-label="Copy expensify_unified_list_users"><code className="connector-page-code">expensify\_unified\_list\_users</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List unified users in Expensify.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_unified_get_user" data-action-label="Get Unified User" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Unified User</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_unified_get_user" aria-label="Copy expensify_unified_get_user"><code className="connector-page-code">expensify\_unified\_get\_user</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a unified Expensify user by ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_list_policies" data-action-label="List Policies" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>List Policies</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_list_policies" aria-label="Copy expensify_list_policies"><code className="connector-page-code">expensify\_list\_policies</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve all Expensify policies (workspaces) accessible to the authenticated user, including policy details, roles, and...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_get_policy" data-action-label="Get Policy" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Get Policy</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_get_policy" aria-label="Copy expensify_get_policy"><code className="connector-page-code">expensify\_get\_policy</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve detailed policy configuration for one or more policies, including expense categories, tags, custom report field...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_create_policy" data-action-label="Create Policy" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Policy</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_create_policy" aria-label="Copy expensify_create_policy"><code className="connector-page-code">expensify\_create\_policy</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Provision a new Expensify expense policy (workspace) with specified name and plan type for organizing expense management...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_update_policy_category" data-action-label="Update Policy Category" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Policy Category</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_update_policy_category" aria-label="Copy expensify_update_policy_category"><code className="connector-page-code">expensify\_update\_policy\_category</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add, update, or replace expense categories on a policy with configurable merge or replace strategy for granular category...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_update_policy_tag" data-action-label="Replace Policy Tags" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Replace Policy Tags</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_update_policy_tag" aria-label="Copy expensify_update_policy_tag"><code className="connector-page-code">expensify\_update\_policy\_tag</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">DESTRUCTIVE FULL REPLACE — overwrites the entire tag level on an Expensify policy with only the tags provided. Existing...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_update_policy_report_field" data-action-label="Update Policy Report Field" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Policy Report Field</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_update_policy_report_field" aria-label="Copy expensify_update_policy_report_field"><code className="connector-page-code">expensify\_update\_policy\_report\_field</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add or update custom report field definitions on a policy for structured expense report data collection</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_export_reports" data-action-label="Export Reports" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Export Reports</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_export_reports" aria-label="Copy expensify_export_reports"><code className="connector-page-code">expensify\_export\_reports</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Generate a CSV/file export of expense reports for accounting integration, audit, and financial reporting. Returns a file...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_download_report" data-action-label="Download Report" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Download Report</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_download_report" aria-label="Copy expensify_download_report"><code className="connector-page-code">expensify\_download\_report</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve CSV file content for previously generated expense report or reconciliation exports to complete data extraction...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_create_report" data-action-label="Create Report" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Create Report</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_create_report" aria-label="Copy expensify_create_report"><code className="connector-page-code">expensify\_create\_report</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create an expense report with an initial expense transaction and submit it for approval. employeeEmail is optional in sc...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="expensify_update_report_status" data-action-label="Update Report Status" data-action-scopes="" data-action-auth="Partner User ID and Secret" data-action-auth-scopes="{&#x22;Partner User ID and Secret&#x22;:[]}">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div>Update Report Status</div>
          <div className="connector-meta-library-item-sub"><button type="button" className="connector-page-code-button" data-copy="expensify_update_report_status" aria-label="Copy expensify_update_report_status"><code className="connector-page-code">expensify\_update\_report\_status</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Mark reports that are ALREADY in Approved state as Reimbursed, for automated reimbursement workflow completion and accou...</div>
      </div>
    </div>
  </div>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.