Skip to content

Fluxx

Fluxx is a cloud-based grants management platform designed to streamline and automate the entire grantmaking process for foundations, corporations, governments, and other funding organizations.

ingestr supports Fluxx as a source.

URI format

The URI format for Fluxx is:

plaintext
fluxx://<instance>?client_id=<client_id>&client_secret=<client_secret>

URI parameters:

  • instance: Your Fluxx instance subdomain (e.g., mycompany.preprod for https://mycompany.preprod.fluxxlabs.com)
  • client_id: OAuth 2.0 client ID for authentication
  • client_secret: OAuth 2.0 client secret for authentication

Example usage

Basic usage - all fields

Assuming your instance is myorg.preprod, you can ingest grant requests into DuckDB using:

bash
ingestr ingest \
--source-uri 'fluxx://myorg.preprod?client_id=your_client_id&client_secret=your_client_secret' \
--source-table 'grant_request' \
--dest-uri duckdb:///fluxx.duckdb \
--dest-table 'raw.grant_request'

Custom field selection

You can select specific fields to ingest using the colon syntax:

bash
ingestr ingest \
--source-uri 'fluxx://myorg.preprod?client_id=your_client_id&client_secret=your_client_secret' \
--source-table 'grant_request:id,amount_requested,amount_recommended,granted' \
--dest-uri duckdb:///fluxx.duckdb \
--dest-table 'raw.grant_request'

Tables

Fluxx source allows ingesting the following sources into separate tables:

TablePKInc KeyInc StrategyDetails
adhoc_reportid-replaceAd-hoc reports with SQL queries, filters, columns configuration, and report metadata
affiliateid-replaceUser affiliations with organizations including contact information, roles, and membership details
claimid-replaceGrant claims and payment requests with approval status, amounts, and dates
claim_expenseid-replaceClaim expense forms and templates for financial tracking
claim_expense_datumid-replaceIndividual data entries within claim expense forms with budget category details
claim_expense_rowid-replaceSpecific line items or rows within claim expense forms
concept_initiativeid-replaceConcept initiatives linking programs, initiatives, and sub-programs/sub-initiatives
dashboard_themeid-replaceDashboard theme configurations for UI customization
etl_claim_expense_datumid-replaceETL data for claim expense items with comprehensive budget tracking details
etl_grantee_budget_tracker_actualid-replaceETL data for actual grantee budget tracker amounts and expenses
etl_grantee_budget_tracker_period_datumid-replaceETL data for grantee budget tracker period information with detailed financial tracking
etl_relationshipid-replaceETL data for entity relationships tracking connections between users, organizations, requests, and other entities
etl_request_budgetid-replaceETL budget data for request funding sources with comprehensive financial details
etl_request_transaction_budgetid-replaceETL budget data for request transaction funding sources including payment tracking
exempt_organizationid-replaceTax-exempt organization data including EIN, classification, and financial information
geo_cityid-replaceCity geographic data with coordinates and postal codes
geo_countyid-replaceCounty geographic data with FIPS codes
geo_placeid-replaceGeographic places with ancestry and location data
geo_regionid-replaceGeographic regions
geo_stateid-replaceState geographic data with abbreviations and FIPS codes
grant_requestid-replaceGrant applications and requests with comprehensive details (300+ fields)
grantee_budget_categoryid-replaceBudget category definitions used by grantees for expense tracking
grantee_budget_trackerid-replaceBudget tracking documents for grantee financial management
grantee_budget_tracker_periodid-replaceTime periods for budget tracking with start and end dates
grantee_budget_tracker_period_datumid-replaceBudget data entries for specific tracking periods
grantee_budget_tracker_period_datum_actualid-replaceActual expenses and amounts recorded for budget tracking periods
grantee_budget_tracker_rowid-replaceIndividual budget line items and categories within budget trackers
integration_logid-replaceIntegration and system logs for tracking data processing and errors
mac_model_type_dyn_financial_auditid-replaceDynamic financial audit models with audit tracking, compliance status, and financial variance analysis
mac_model_type_dyn_melid-replaceDynamic Monitoring, Evaluation & Learning (MEL) models with performance indicators, baseline tracking, and evaluation metrics
mac_model_type_dyn_toolid-replaceDynamic tool management models for tracking deployment status, usage metrics, and tool effectiveness
machine_categoryid-replaceMachine category definitions for workflow state management
model_attribute_valueid-replaceModel attribute values with hierarchical data and dependencies
model_documentid-replaceDocument metadata including file information, storage details, and document relationships
model_document_sub_typeid-replaceDocument sub-type definitions and categories
model_document_typeid-replaceDocument type configurations including DocuSign integration and permissions
model_themeid-replaceModel themes for categorization and program hierarchy organization
organizationid-replaceOrganizations (grantees, fiscal sponsors, etc.) with contact information and tax details
population_estimateid-replacePopulation estimates by geographic area with demographic data
population_estimate_yearid-replaceYearly population estimates with income and demographic breakdowns
programid-replaceFunding programs and initiatives
request_reportid-replaceReports submitted for grants
request_transactionid-replaceFinancial transactions and payments
request_transaction_funding_sourceid-replaceFunding source details for specific request transactions
request_userid-replaceRelationships between requests and users with roles and descriptions
salesforce_authenticationid-replaceSalesforce authentication configurations with OAuth tokens, connection management, and API usage tracking
sub_initiativeid-replaceSub-initiatives for detailed planning
sub_programid-replaceSub-programs under main programs
ui_versionid-replaceUser interface version information and system configuration
userid-replaceUser accounts and profiles
user_organizationid-replaceRelationships between users and organizations with roles, departments, and contact details
affiliate_typeid-replaceAffiliate Type management and tracking
aha_requirements_ticketsid-replaceAha Requirements Tickets management and tracking
alertid-replaceAlert management and tracking
alert_email_userid-replaceAlert Email User management and tracking
alert_model_logid-replaceAlert Model Log management and tracking
alert_recipientid-replaceAlert Recipient management and tracking
alert_transition_stateid-replaceAlert Transition State management and tracking
bank_accountid-replaceBank Account management and tracking
budget_requestid-replaceBudget Request management and tracking
card_configurationid-replaceCard Configuration management and tracking
census_code_resultid-replaceCensus Code Result management and tracking
census_configid-replaceCensus Config management and tracking
claim_expense_row_documentid-replaceClaim Expense Row Document management and tracking
clean_calculationid-replaceClean Calculation management and tracking
client_configurationid-replaceClient Configuration management and tracking
client_storeid-replaceClient Store management and tracking
client_store_dashboard_groupid-replaceClient Store Dashboard Group management and tracking
clone_ancestryid-replaceClone Ancestry management and tracking
code_block_conversionid-replaceCode Block Conversion management and tracking
coiid-replaceCoi management and tracking
compliance_checklist_itemid-replaceCompliance Checklist Item management and tracking
config_model_documentid-replaceConfig Model Document management and tracking
configuration_valueid-replaceConfiguration Value management and tracking
cpiid-replaceCpi management and tracking
dashboard_groupid-replaceDashboard Group management and tracking
dashboard_templateid-replaceDashboard Template management and tracking
demographic_categoryid-replaceDemographic Category management and tracking
demographic_itemid-replaceDemographic Item management and tracking
documentid-replaceDocument management and tracking
docusign_tokenid-replaceDocusign Token management and tracking
email_userid-replaceEmail User management and tracking
expirable_tokenid-replaceExpirable Token management and tracking
extract_formatid-replaceExtract Format management and tracking
favoriteid-replaceFavorite management and tracking
field_listid-replaceField List management and tracking
filterid-replaceFilter management and tracking
formid-replaceForm management and tracking
form_elementid-replaceForm Element management and tracking
fundid-replaceFund management and tracking
fund_docketid-replaceFund Docket management and tracking
fund_line_itemid-replaceFund Line Item management and tracking
funding_sourceid-replaceFunding Source management and tracking
funding_source_allocationid-replaceFunding Source Allocation management and tracking
funding_source_allocation_authorityid-replaceFunding Source Allocation Authority management and tracking
funding_source_forecastid-replaceFunding Source Forecast management and tracking
fx_conversionid-replaceFx Conversion management and tracking
fx_typeid-replaceFx Type management and tracking
generic_templateid-replaceGeneric Template management and tracking
geo_countryid-replaceGeo Country management and tracking
geo_place_relationshipid-replaceGeo Place Relationship management and tracking
grant_outcomeid-replaceGrant Outcome management and tracking
grant_outcome_progress_reportid-replaceGrant Outcome Progress Report management and tracking
grant_outcome_progress_report_rowid-replaceGrant Outcome Progress Report Row management and tracking
grant_outcome_rowid-replaceGrant Outcome Row management and tracking
grant_outputid-replaceGrant Output management and tracking
grant_output_periodid-replaceGrant Output Period management and tracking
grant_output_period_datumid-replaceGrant Output Period Datum management and tracking
grant_output_progress_reportid-replaceGrant Output Progress Report management and tracking
grant_output_progress_report_datumid-replaceGrant Output Progress Report Datum management and tracking
grant_output_rowid-replaceGrant Output Row management and tracking
grantee_budgetid-replaceGrantee Budget management and tracking
grantee_budget_category_groupid-replaceGrantee Budget Category Group management and tracking
grantee_budget_category_group_relationshipid-replaceGrantee Budget Category Group Relationship management and tracking
grantee_budget_tracker_period_amendmentid-replaceGrantee Budget Tracker Period Amendment management and tracking
grantee_whitelistid-replaceGrantee Whitelist management and tracking
groupid-replaceGroup management and tracking
group_memberid-replaceGroup Member management and tracking
gs_streamid-replaceGs Stream management and tracking
gs_stream_documentid-replaceGs Stream Document management and tracking
gs_stream_gs_tagid-replaceGs Stream Gs Tag management and tracking
gs_stream_requestid-replaceGs Stream Request management and tracking
gs_tagid-replaceGs Tag management and tracking
indicatorid-replaceIndicator management and tracking
integration_filterid-replaceIntegration Filter management and tracking
jobid-replaceJob management and tracking
languageid-replaceLanguage management and tracking
login_attemptid-replaceLogin Attempt management and tracking
loiid-replaceLoi management and tracking
machine_eventid-replaceMachine Event management and tracking
machine_event_from_stateid-replaceMachine Event From State management and tracking
machine_event_roleid-replaceMachine Event Role management and tracking
machine_model_typeid-replaceMachine Model Type management and tracking
machine_stateid-replaceMachine State management and tracking
machine_state_categoryid-replaceMachine State Category management and tracking
machine_state_groupid-replaceMachine State Group management and tracking
machine_workflowid-replaceMachine Workflow management and tracking
machine_workflow_forkid-replaceMachine Workflow Fork management and tracking
matching_gift_profileid-replaceMatching Gift Profile management and tracking
mentionid-replaceMention management and tracking
migrate_rowid-replaceMigrate Row management and tracking
migrationid-replaceMigration management and tracking
migration_configid-replaceMigration Config management and tracking
migration_config_columnid-replaceMigration Config Column management and tracking
migration_config_modelid-replaceMigration Config Model management and tracking
migration_config_model_linkid-replaceMigration Config Model Link management and tracking
migration_fileid-replaceMigration File management and tracking
model_attributeid-replaceModel Attribute management and tracking
model_attribute_choiceid-replaceModel Attribute Choice management and tracking
model_clone_configurationid-replaceModel Clone Configuration management and tracking
model_document_dynamic_recipientid-replaceModel Document Dynamic Recipient management and tracking
model_document_masterid-replaceModel Document Master management and tracking
model_document_signid-replaceModel Document Sign management and tracking
model_document_sign_envelopeid-replaceModel Document Sign Envelope management and tracking
model_document_templateid-replaceModel Document Template management and tracking
model_emailid-replaceModel Email management and tracking
model_methodid-replaceModel Method management and tracking
model_summaryid-replaceModel Summary management and tracking
model_validationid-replaceModel Validation management and tracking
model_validation_fieldid-replaceModel Validation Field management and tracking
modificationid-replaceModification management and tracking
multi_element_choiceid-replaceMulti Element Choice management and tracking
multi_element_groupid-replaceMulti Element Group management and tracking
multi_element_valueid-replaceMulti Element Value management and tracking
noteid-replaceNote management and tracking
ofac_personid-replaceOfac Person management and tracking
organization_connection_requestid-replaceOrganization Connection Request management and tracking
outcomeid-replaceOutcome management and tracking
periodic_syncid-replacePeriodic Sync management and tracking
perishable_tokenid-replacePerishable Token management and tracking
permission_delegatorid-replacePermission Delegator management and tracking
personaid-replacePersona management and tracking
postid-replacePost management and tracking
post_relationshipid-replacePost Relationship management and tracking
post_viewid-replacePost View management and tracking
primary_contact_tenureid-replacePrimary Contact Tenure management and tracking
program_budgetid-replaceProgram Budget management and tracking
projectid-replaceProject management and tracking
project_listid-replaceProject List management and tracking
project_list_itemid-replaceProject List Item management and tracking
project_organizationid-replaceProject Organization management and tracking
project_requestid-replaceProject Request management and tracking
project_userid-replaceProject User management and tracking
real_me_invitationid-replaceReal Me Invitation management and tracking
realtime_updateid-replaceRealtime Update management and tracking
recommendation_emailid-replaceRecommendation Email management and tracking
reduce_indexing_recordid-replaceReduce Indexing Record management and tracking
relationshipid-replaceRelationship management and tracking
relationship_schema_mappingid-replaceRelationship Schema Mapping management and tracking
request_amendmentid-replaceRequest Amendment management and tracking
request_amendment_model_themesid-replaceRequest Amendment Model Themes management and tracking
request_evaluation_metricid-replaceRequest Evaluation Metric management and tracking
request_funding_sourceid-replaceRequest Funding Source management and tracking
request_geo_stateid-replaceRequest Geo State management and tracking
request_organizationid-replaceRequest Organization management and tracking
request_outcomeid-replaceRequest Outcome management and tracking
request_programid-replaceRequest Program management and tracking
request_recommendationid-replaceRequest Recommendation management and tracking
request_recommenderid-replaceRequest Recommender management and tracking
request_regrantid-replaceRequest Regrant management and tracking
request_reviewid-replaceRequest Review management and tracking
request_review_setid-replaceRequest Review Set management and tracking
request_reviewer_assignmentid-replaceRequest Reviewer Assignment management and tracking
roleid-replaceRole management and tracking
role_userid-replaceRole User management and tracking
sectionid-replaceSection management and tracking
segmentid-replaceSegment management and tracking
segment_tagid-replaceSegment Tag management and tracking
shared_cardid-replaceShared Card management and tracking
sms_logid-replaceSms Log management and tracking
spending_forecastid-replaceSpending Forecast management and tracking
sphinx_checkid-replaceSphinx Check management and tracking
stencilid-replaceStencil management and tracking
stencil_bookid-replaceStencil Book management and tracking
stencil_book_pageid-replaceStencil Book Page management and tracking
stencil_formid-replaceStencil Form management and tracking
sub_modelid-replaceSub Model management and tracking
table_viewid-replaceTable View management and tracking
table_view_favoriteid-replaceTable View Favorite management and tracking
tagid-replaceTag management and tracking
taggingid-replaceTagging management and tracking
transaction_report_dependencyid-replaceTransaction Report Dependency management and tracking
translator_assignmentid-replaceTranslator Assignment management and tracking
translator_languageid-replaceTranslator Language management and tracking
user_emailid-replaceUser Email management and tracking
user_permissionid-replaceUser Permission management and tracking
user_profileid-replaceUser Profile management and tracking
user_profile_ruleid-replaceUser Profile Rule management and tracking
user_segment_tagid-replaceUser Segment Tag management and tracking
webhook_subscriptionid-replaceWebhook Subscription management and tracking
wiki_documentid-replaceWiki Document management and tracking
wiki_document_templateid-replaceWiki Document Template management and tracking
work_taskid-replaceWork Task management and tracking
workflow_eventid-replaceWorkflow Event management and tracking
zenith_user_configurationid-replaceZenith User Configuration management and tracking

Use these as --source-table parameter in the ingestr ingest command.

Field Selection

Each resource contains numerous fields. You can:

  1. Ingest all fields: Use the resource name directly (e.g., grant_request)
  2. Select specific fields: Use colon syntax (e.g., grant_request:id,name,amount_requested)

The field selection feature is particularly useful for large resources like grant_request which has over 300 fields.

Authentication

Fluxx uses OAuth 2.0 with client credentials flow. To obtain credentials:

  1. Contact your Fluxx administrator to create an API client
  2. You'll receive a client_id and client_secret
  3. Note your Fluxx instance subdomain (the part before .fluxxlabs.com)