Common Issues

Connection issues

"Unexpected token" error when exporting reports

Salesforce reports that contain special characters (like underscores) in column headers can cause parsing errors. This usually happens with matrix or summary reports that don't export cleanly as tabular data.

Fix: Ensure your report is in tabular format (not matrix or summary). If it is, try exporting the report directly from Salesforce first to confirm the format is clean. If the report still fails, use the Objects or Custom SOQL data type instead to pull the underlying data directly.

Connection fails with custom Salesforce domain

If your Salesforce org uses a custom domain (not the standard login.salesforce.com), the OAuth flow may not recognize your login URL.

Fix: When signing in to Coupler.io, you may need to manually enter your custom domain URL. If this persists, contact Coupler.io support with your domain name and we can help route the connection correctly.

Cannot connect to Salesforce sandbox

Sandbox environments require a slightly different login URL than production orgs.

Fix: When authorizing, use your sandbox login credentials and ensure the login URL includes sandbox (e.g., https://yourorg--sandbox.sandbox.my.salesforce.com). Coupler.io supports both production and sandbox orgs.

"REST API is not enabled for this organization" error

Your Salesforce org may have API access disabled, which Coupler.io requires to pull data.

Fix: Contact your Salesforce administrator and request that the REST API be enabled for your org. This is typically found under Setup > System Overview > API is enabled.

Missing data

Custom fields are not appearing in the export

When exporting Objects, custom fields won't be included automatically. You must explicitly specify them in the Columns field.

Fix: In the Columns field, list the API names of your custom fields (e.g., Customer_Tier__c, ARR__c). Custom field API names typically end with __c. If you don't know the exact API names, check Salesforce Setup > Custom Fields & Relationships for your object.

Report shows data in Salesforce but nothing exports to Coupler.io

This usually happens if the report is in matrix or summary format, which Coupler.io doesn't support, or if the report has no data for the selected date range.

Fix: Verify the report is in tabular format. In Salesforce, edit the report and check the format setting. Also check the report's date range—if you're using a custom date filter in Coupler.io, ensure it overlaps with data in your Salesforce org.

SOQL query returns no results but I know data exists

Syntax errors in your SOQL query or incorrect field/object names will cause the query to return empty results.

Fix: Check your SOQL syntax against Salesforce documentation. Verify object and field names are spelled correctly (case-sensitive). Test the query in Salesforce's Developer Console first.

Permission errors

"Insufficient privileges" error during connection

Your Salesforce user account doesn't have permission to authorize third-party applications like Coupler.io.

Fix: Ask a Salesforce administrator to authorize the Coupler.io OAuth app, or request that your user profile be granted "Manage Connected Apps" permission.

Can see some objects but not others

Your Salesforce user profile has field-level security or object-level security restrictions that limit what you can export.

Fix: Contact your Salesforce administrator to grant read access to the objects or fields you need. They can adjust security settings under Setup > Security Controls > Field-Level Security or Object-Level Security.

Data discrepancies

Report data in Coupler.io doesn't match Salesforce

Reports often contain summaries, subtotals, or grouping logic that may not match the raw record count. Also, the date range override in Coupler.io changes what the report filters.

Fix: Compare the date range and filters in your Coupler.io data flow settings with the report definition in Salesforce. If you override the report's date range in Coupler.io, the exported data will reflect those new dates. For a true comparison, export the report directly from Salesforce with the same date range and filters.

Duplicate records appearing in exports

Duplicate records sometimes occur if a data flow is run multiple times in quick succession or if SOQL filters aren't specific enough.

Fix: Check your data flow's filter settings. If using Objects, add a more specific WHERE clause in SOQL (e.g., filter by status or date range). For scheduled data flows, ensure you're not appending to destination data without cleaning up old records first.

Rate limits

Large exports are slow or timeout

Salesforce limits API calls per user per 24 hours. Large exports consume multiple API calls and may hit this limit.

Fix: Split large exports into smaller data flows (e.g., by date range or account segment). Schedule data flows during off-peak hours to avoid competing requests. For very large exports, contact Coupler.io support to discuss optimizations or reach out to Salesforce about raising your API call limits.

"API request limit exceeded" error

Your org has hit its daily API call quota due to multiple imports, reports, or other API integrations running simultaneously.

Fix: Stagger your data flow schedules so they don't all run at the same time. Remove or pause data flows you no longer need. Contact your Salesforce administrator to check your API usage in Setup > System Overview.