Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Expensify

This documentation for the Expensify integration describes the technical capabilities of this integration, including authorization, scopes/permissions, and utilized endpoints. For more information on how to integrate Expensify, visit our connection instructions.

Version​

This integration utilizes the Expensify Expensify Integration Server API.

Base URL​

The base URL used for all Expensify API endpoints:
https://integrations.expensify.com/Integration-Server

Endpoints Utilized​

DataGrail uses the following endpoints to authorize and test the connection:

MethodEndpointPurposeDocs
POST/ExpensifyIntegrationsValidate credentials

Authentication & Authorization​

The DataGrail Expensify integration connects using Credential-Based Authentication via Request Body authentication which requires a Partner User ID and Partner User Secret.

Sensitive Credentials
Publicly exposing your API credentials can allow unauthorized access to Expensify API endpoints by a third party. DataGrail stores your API credentials encrypted and protected.

Limits​

Limits in Expensify are calculated using the leaky bucket algorithm. All requests that are made after rate limits have been exceeded are throttled and an HTTP 429 Too Many Requests error is returned. Requests succeed again after enough requests have emptied out of the bucket.

  • DataGrail supports requests throttling to stay within 70-80% of specified service rate limits.
  • DataGrail processes API responses with HTTP 429 status to interrupt requests, waiting and retrying (using an exponential backoff strategy).

Capabilities​

System Detection​

DataGrail provides continuous system detection, delivering a real-time inventory of your data assets.

Data Interactions​

DataGrail's System Detection process runs once daily and performs the following actions:

  1. Call the Report Exporter API endpoint to export Expensify data.
  2. Download the file and extract the report data.

Endpoints Utilized​

MethodEndpointPurposeDocs
POST/ExpensifyIntegrationsCall Report Exporter

 

Need help?
If you have any questions, please reach out to your dedicated Account Manager or contact us at support@datagrail.io.

Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.