> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/other/ashby/common-issues.md).
# Common Issues
## Connection issues
My API key is rejected and the connection fails
Double-check that you copied the full API key from Ashby without any trailing spaces. API keys are generated under **Settings → Integrations → API Keys** — make sure you're using a key from this section and not a webhook secret or another credential. If the key was created for a limited integration scope, it may not have permission to access all entities. Try generating a new key with full access.
The data flow connects but returns no data
If the connection succeeds but the export is empty, check your **start date** parameter. If you've set a start date that's in the future or very recent, no records will match. Try clearing the start date to export all available data and confirm there are records in Ashby for the selected entity.
## Missing data
Some candidates or applications are missing from the export
Ashby's API may not return archived or deleted records depending on the entity and your account configuration. Check whether the missing records have been archived in Ashby. Also verify your start date filter — records created before the start date won't be included.
Custom fields are not appearing in my export
Custom fields only appear if they have been populated on at least some records. If a custom field exists in Ashby but has no values, it may not show up as a column. Try exporting the **Custom fields** entity separately to see all defined fields, then cross-reference with your Candidates or Applications data.
Interview schedules show incomplete data
Interview schedules are tied to specific applications. If an interview was cancelled or the application was archived before the schedule was confirmed, it may appear incomplete. Check the application status in Ashby to confirm the record is in the expected state.
## Permission errors
I get a 403 or "unauthorized" error when running the data flow
This usually means your API key doesn't have sufficient permissions. In Ashby, API key permissions can be scoped — ask your Ashby admin to verify the key has read access to the entities you're trying to export. If you're not the account admin, you may need to request a new key with broader access.
## Data discrepancies
Counts in Coupler.io don't match what I see in Ashby reports
Ashby's built-in reports may apply default filters (e.g., only active jobs, only specific date ranges) that differ from a raw API export. Coupler.io pulls unfiltered data unless you set a start date. Compare the raw record count in your export against Ashby with all filters removed to check for alignment.
## Rate limits
My data flow times out or returns partial data on large exports
Ashby's API enforces rate limits that may slow down large exports. Coupler.io handles pagination automatically, but very large datasets (e.g., thousands of candidates with full history) may take longer to complete. If you're hitting consistent issues, try narrowing your export using the start date parameter to pull data in smaller windows.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.coupler.io/sources/category/other/ashby/common-issues.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.