Provider first requests
Public catalog snapshots observed 2026-10-28; first-request templates reviewed 2026-09-07.
- staging (
https://api-staging.fictix.ai/api/v1/catalog/connector-capabilities, observed 2026-10-28): 60 catalog entries, 60 listed as available/preview, and 59 marked selectable; status histogram 59 available, 1 preview; fidelity histogram 60 approximate. -
production (
https://api.fictix.ai/api/v1/catalog/connector-capabilities, observed 2026-10-28): 60 catalog entries, 60 listed as available/preview, and 59 marked selectable; status histogram 59 available, 1 preview; fidelity histogram 60 approximate. These status and fidelity values are public catalog reports. They do not show that each provider request succeeded, establish production request behavior, or promise strict upstream API parity. The request templates below were tested in staging only. Plan entitlements and company selection still apply.
FCI catalog status: staging: preview, not selectable; production: preview, not selectable. It uses execute and is not selectable
in the standard connector picker. Check capability availability for your
company before using its preview request.
Start with Connect your software for keys, SDK base URLs, scopes, and error handling. Read Provider workflows for supported writes, filters, pagination, and limits.
Download all first requests as JSON. The file contains public request templates and source release IDs; it contains no keys.
Request base and authentication
Append each table path to /api/v1/orgs/{slug}/ on your chosen API origin.
Use https://api-staging.fictix.ai for staging and https://api.fictix.ai for
production. Send the matching company or organization key as X-API-Key.
Every first request needs read; FCI additionally needs execute.
For a GET, replace the path below with the one from the table:
curl --fail-with-body -sS \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/stripe/v1/customers" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY"
POST read bodies and their content types are included below the table. These requests do not require a native-write idempotency key. Replace the two FCI body placeholders with the selected company project ID and a unique request ID.
Provider directory
| Provider / ID | Staging-tested first request | Public catalog report |
|---|---|---|
BILL / billcom |
GET native/billcom/v3/vendors |
staging: available, selectable; production: available, selectable |
Expensify / expensify |
POST native/expensify/Integration-Server/ExpensifyIntegrations (body) |
staging: available, selectable; production: available, selectable |
FreshBooks / freshbooks |
GET native/freshbooks/accounting/account/FICTIX/users/clients |
staging: available, selectable; production: available, selectable |
QuickBooks Online / qbo |
GET native/qbo/v3/company/test/query?query=SELECT%20*%20FROM%20Customer |
staging: available, selectable; production: available, selectable |
Xero / xero |
GET native/xero/api.xro/2.0/Contacts |
staging: available, selectable; production: available, selectable |
Zoho Books / zoho_books |
GET native/zoho_books/books/v3/contacts?organization_id=100000000000001 |
staging: available, selectable; production: available, selectable |
Chase / chase |
GET native/chase/embedded/v1/accounts |
staging: available, selectable; production: available, selectable |
Mercury / mercury |
GET native/mercury/accounts |
staging: available, selectable; production: available, selectable |
Plaid / plaid |
POST native/plaid/transactions/get (body) |
staging: available, selectable; production: available, selectable |
Wise Business / wise_business |
GET native/wise_business/2026Q3/profiles |
staging: available, selectable; production: available, selectable |
Close / close |
GET native/close/api/v1/lead/ |
staging: available, selectable; production: available, selectable |
HubSpot / hubspot |
GET native/hubspot/crm/v3/objects/contacts |
staging: available, selectable; production: available, selectable |
Pipedrive / pipedrive |
GET native/pipedrive/api/v2/persons |
staging: available, selectable; production: available, selectable |
Salesforce / salesforce |
GET native/salesforce/services/data/v66.0/query?q=SELECT%20Id%2CName%20FROM%20Account |
staging: available, selectable; production: available, selectable |
Brex / brex |
GET native/brex/v2/accounts/cash |
staging: available, selectable; production: available, selectable |
Ramp / ramp |
GET native/ramp/developer/v1/transactions |
staging: available, selectable; production: available, selectable |
Shopify / shopify |
GET native/shopify/admin/api/2025-10/customers.json |
staging: available, selectable; production: available, selectable |
Gmail / gmail |
GET native/gmail/gmail/v1/users/me/messages |
staging: available, selectable; production: available, selectable |
Outlook / outlook |
GET native/outlook/v1.0/me/events |
staging: available, selectable; production: available, selectable |
Slack / slack |
GET native/slack/api/users.list |
staging: available, selectable; production: available, selectable |
GitHub / github |
GET native/github/user/repos |
staging: available, selectable; production: available, selectable |
DocuSign / docusign |
GET native/docusign/oauth/userinfo |
staging: available, selectable; production: available, selectable |
NetSuite / netsuite |
GET native/netsuite/services/rest/record/v1/customer |
staging: available, selectable; production: available, selectable |
SAP / sap |
GET native/sap/sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartner |
staging: available, selectable; production: available, selectable |
Sage Intacct / sage_intacct |
POST native/sage_intacct/ia/xml/xmlgw.phtml (body) |
staging: available, selectable; production: available, selectable |
Dropbox / dropbox |
POST native/dropbox/2/files/list_folder (body) |
staging: available, selectable; production: available, selectable |
Google Drive / google_drive |
GET native/google_drive/drive/v3/files |
staging: available, selectable; production: available, selectable |
OneDrive / onedrive |
GET native/onedrive/v1.0/me/drive/root/children |
staging: available, selectable; production: available, selectable |
FCI / fci |
POST execute (body) |
staging: preview, not selectable; production: preview, not selectable |
ADP / adp |
GET native/adp/hr/v2/workers |
staging: available, selectable; production: available, selectable |
BambooHR / bamboohr |
GET native/bamboohr/api/v1/employees |
staging: available, selectable; production: available, selectable |
Deel / deel |
GET native/deel/rest/people |
staging: available, selectable; production: available, selectable |
Justworks / justworks |
GET native/justworks/v1/members |
staging: available, selectable; production: available, selectable |
Rippling / rippling |
GET native/rippling/workers/ |
staging: available, selectable; production: available, selectable |
TriNet HR Platform / trinet |
GET native/trinet/core/people |
staging: available, selectable; production: available, selectable |
Workday / workday |
GET native/workday/staffing/v7/workers |
staging: available, selectable; production: available, selectable |
Google Ads / google_ads |
GET native/google_ads/v25/customers:listAccessibleCustomers |
staging: available, selectable; production: available, selectable |
Google Analytics 4 / google_analytics_4 |
GET native/google_analytics_4/v1beta/properties/1000000001/metadata |
staging: available, selectable; production: available, selectable |
Klaviyo / klaviyo |
GET native/klaviyo/api/profiles |
staging: available, selectable; production: available, selectable |
Mailchimp / mailchimp |
GET native/mailchimp/3.0/lists |
staging: available, selectable; production: available, selectable |
Meta Ads / meta_ads |
GET native/meta_ads/v26.0/me/adaccounts |
staging: available, selectable; production: available, selectable |
Airtable / airtable |
GET native/airtable/v0/meta/bases |
staging: available, selectable; production: available, selectable |
Adyen / adyen |
POST native/adyen/v72/paymentMethods (body) |
staging: available, selectable; production: available, selectable |
Chargebee / chargebee |
GET native/chargebee/api/v2/customers |
staging: available, selectable; production: available, selectable |
Paddle / paddle |
GET native/paddle/customers |
staging: available, selectable; production: available, selectable |
PayPal / paypal |
GET native/paypal/v1/catalogs/products |
staging: available, selectable; production: available, selectable |
Recurly / recurly |
GET native/recurly/accounts |
staging: available, selectable; production: available, selectable |
Square / square |
GET native/square/v2/customers |
staging: available, selectable; production: available, selectable |
Stripe / stripe |
GET native/stripe/v1/customers |
staging: available, selectable; production: available, selectable |
Gusto / gusto |
GET native/gusto/v1/employees |
staging: available, selectable; production: available, selectable |
Excel / excel |
GET native/excel/v1.0/me/drive/items/fictix-finance-workbook/workbook/worksheets |
staging: available, selectable; production: available, selectable |
Asana / asana |
GET native/asana/api/1.0/tasks |
staging: available, selectable; production: available, selectable |
ClickUp / clickup |
GET native/clickup/api/v2/team |
staging: available, selectable; production: available, selectable |
Linear / linear |
POST native/linear/graphql (body) |
staging: available, selectable; production: available, selectable |
Monday / monday |
POST native/monday/v2 (body) |
staging: available, selectable; production: available, selectable |
Freshdesk / freshdesk |
GET native/freshdesk/api/v2/contacts |
staging: available, selectable; production: available, selectable |
Front / front |
GET native/front/contacts |
staging: available, selectable; production: available, selectable |
Help Scout / help_scout |
GET native/help_scout/v2/customers |
staging: available, selectable; production: available, selectable |
Intercom / intercom |
GET native/intercom/contacts |
staging: available, selectable; production: available, selectable |
Zendesk / zendesk |
GET native/zendesk/api/v2/users |
staging: available, selectable; production: available, selectable |
Relay Financial is unavailable: a direct API contract has not been implemented.
FCI uses execute. TriNet means HR Platform
(formerly Zenefits); it does not describe TriNet PEO.
POST read bodies
The examples use the company-key variables from the connection guide. If you
use an organization key, substitute $FICTIX_ORGANIZATION_API_KEY in the header.
Expensify request
Expensify: send application/x-www-form-urlencoded.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/expensify/Integration-Server/ExpensifyIntegrations" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data-raw 'requestJobDescription=%7B%22type%22%3A%22get%22%2C%22inputSettings%22%3A%7B%22type%22%3A%22policyList%22%7D%7D'
Plaid request
Plaid: send application/json.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/plaid/transactions/get" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{}'
Sage Intacct request
Sage Intacct: send application/xml.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/sage_intacct/ia/xml/xmlgw.phtml" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/xml" \
--data-raw '<request><control><senderid>fictix-sdk</senderid><controlid>first-read</controlid><uniqueid>true</uniqueid><dtdversion>3.0</dtdversion></control><operation transaction="true"><content><function controlid="first-read"><readByQuery><object>CUSTOMER</object><fields>*</fields><query/><pagesize>10</pagesize></readByQuery></function></content></operation></request>'
Dropbox request
Dropbox: send application/json.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/dropbox/2/files/list_folder" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"path":""}'
FCI request
FCI: send application/json.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/execute" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"org_id":"replace_with_company_project_id","user_id":"fictix-ui","turn_id":"replace_with_unique_request_id","capability_key":"fci.cash","args":{}}'
Adyen request
Adyen: send application/json.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/adyen/v72/paymentMethods" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"merchantAccount":"FictixDemo"}'
Linear request
Linear: send application/json.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/linear/graphql" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"query":"query { teams { nodes { id name } } }"}'
Monday request
Monday: send application/json.
curl --fail-with-body -sS -X POST \
"$FICTIX_API_ORIGIN/api/v1/orgs/$FICTIX_PROJECT_SLUG/native/monday/v2" \
-H "X-API-Key: $FICTIX_PROJECT_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{"query":"query { boards { id name } }"}'
Check application status
An HTTP 200 alone is insufficient for GraphQL, Sage Intacct, Expensify, and
execute responses. Inspect GraphQL errors, XML operation statuses,
Expensify responseCode, or execute status before using the returned data.
See the connection guide for scope and error handling.
