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.