File exchange
Exchange files with Figure, one way or both ways, through Google Cloud Storage, AWS S3, or SFTP.
On this page· 5 sections
Partner-hosted storage solution required
Private Label Data Export files can only be delivered to a storage solution hosted by the partner. Figure does not host the storage solution for you. All reports are also available for download from Lead Portal.
Data Export files must use PGP encryption. See PGP keys for encryption.
Recommended methods#
Use this order for new integrations:
Recommended
Google Cloud Storage
Grant a Figure service account on your bucket. No keys to exchange.
Also supported
AWS S3
Let Figure assume a role in your account, or use a Figure-hosted bucket.
Last resort
SFTP
SSH-key authentication only. Passwords are not supported.
SFTP is not recommended. Google Cloud Storage and AWS S3 offer improved reliability and simpler lifecycle management.
For dataset sharing models still being expanded, see Other sharing options and contact us.
Direction of transfer#
Figure delivers files to you (for example Data Export): you host the destination. Use a partner-hosted bucket or SFTP server.
You deliver files to Figure: we can host the destination (Figure-hosted GCS, S3, or SFTP), or you can grant us access to storage you host.
Each method's page covers both directions.
If you allowlist the addresses that connect to storage you host, use the file-exchange IP addresses. They are separate from the API ranges.
Environments and testing#
Figure has separate test and production file-exchange destinations. Do not mix test and production credentials, buckets, roles, or allowlists.
For cross-account S3, use separate delivery roles (or trust policies) and buckets for test and production, each trusting the Role A ARN Figure provides for that environment during onboarding. See Cross-account IAM role.
For Data Export:
- Test files are prefixed
test_. Production files have no prefix. See File Naming Conventions. - Exports are full snapshots (not deltas), on a partner-configurable schedule. See Delivery Schedules and Data Freshness and Will Figure deliver full exports or delta-files?.
To validate an integration before go-live, use the test environment. If you need a sample file that matches the production schema with dummy data, ask your Figure contact or email partner-help@figure.com.
Other sharing options#
The methods above are the standard path. The options below are on our roadmap or available by arrangement. Contact us if you want to be an early adopter:
- Granting a Figure AWS principal on your S3 bucket policy without role assumption or exchanging long-lived access keys
- Google Analytics Hub (BigQuery dataset sharing)
- AWS Data Exchange
Unsupported methods#
Figure does not currently support file transfers to Azure or via FTP(S).
Have a question about access, credentials, or cadence? See the FAQ.