# Fuse API

## Docs

- [Get the token owner's credit balance](https://docs.fuseai.com/api-reference/account/get-the-token-owners-credit-balance.md)
- [Get the token owner's identity](https://docs.fuseai.com/api-reference/account/get-the-token-owners-identity.md)
- [Approve (activate) a draft campaign](https://docs.fuseai.com/api-reference/campaigns/approve-activate-a-draft-campaign.md): Requires one of the following token scopes: campaigns.
- [Create a draft campaign](https://docs.fuseai.com/api-reference/campaigns/create-a-draft-campaign.md): Requires one of the following token scopes: campaigns.
- [Edit a sequence step](https://docs.fuseai.com/api-reference/campaigns/edit-a-sequence-step.md): Set `subject`/`body` for manual steps, or `topic` for AI-generated steps. An AI campaign built from a manual-derived template needs a `topic` on each AI step before it can be approved.
- [Get a campaign's status](https://docs.fuseai.com/api-reference/campaigns/get-a-campaigns-status.md): Poll this after creating a campaign: `initializationStatus` moves to `completed` when the draft is ready to review and approve. `initializationError` carries our own status text when an AI initialization fails.
- [List a campaign's sequence steps](https://docs.fuseai.com/api-reference/campaigns/list-a-campaigns-sequence-steps.md): Requires one of the following token scopes: campaigns.
- [Resolve the caller's contact by LinkedIn URL](https://docs.fuseai.com/api-reference/contacts/resolve-the-callers-contact-by-linkedin-url.md): Requires one of the following token scopes: contacts.
- [Create a custom column on a list](https://docs.fuseai.com/api-reference/custom-columns/create-a-custom-column-on-a-list.md): Requires one of the following token scopes: lists.
- [List a list's custom column definitions](https://docs.fuseai.com/api-reference/custom-columns/list-a-lists-custom-column-definitions.md): Requires one of the following token scopes: lists.
- [Write custom column values (keyed by contact id)](https://docs.fuseai.com/api-reference/custom-columns/write-custom-column-values-keyed-by-contact-id.md): Requires one of the following token scopes: lists.
- [Poll an export job (presigned download URL when completed)](https://docs.fuseai.com/api-reference/exports/poll-an-export-job-presigned-download-url-when-completed.md): Requires one of the following token scopes: lists.
- [Start an async CSV export of a list (returns a jobId)](https://docs.fuseai.com/api-reference/exports/start-an-async-csv-export-of-a-list-returns-a-jobid.md): Requires one of the following token scopes: lists.
- [List the token owner's knowledge hubs](https://docs.fuseai.com/api-reference/knowledge-hubs/list-the-token-owners-knowledge-hubs.md): Knowledge hubs ground AI campaign generation in your company's content. Pass a hub's `id` as `knowledgeHubId` when creating an AI campaign. A hub with status `processing` is still ingesting; grounding a campaign on it yields thinner content than waiting for `complete`.
- [Add existing contacts to a list (by id)](https://docs.fuseai.com/api-reference/lists/add-existing-contacts-to-a-list-by-id.md): Requires one of the following token scopes: lists.
- [Create a prospect list](https://docs.fuseai.com/api-reference/lists/create-a-prospect-list.md): Requires one of the following token scopes: lists.
- [List a list's contacts (with ids and column values)](https://docs.fuseai.com/api-reference/lists/list-a-lists-contacts-with-ids-and-column-values.md): Requires one of the following token scopes: lists.
- [List the token owner's prospect lists](https://docs.fuseai.com/api-reference/lists/list-the-token-owners-prospect-lists.md): Requires one of the following token scopes: lists.
- [Remove contacts from a list](https://docs.fuseai.com/api-reference/lists/remove-contacts-from-a-list.md): Requires one of the following token scopes: lists.
- [Upload new contact data into a list (RAW upload)](https://docs.fuseai.com/api-reference/lists/upload-new-contact-data-into-a-list-raw-upload.md): Requires one of the following token scopes: lists.
- [Get the accepted prospect-search filter values](https://docs.fuseai.com/api-reference/prospect-search/get-the-accepted-prospect-search-filter-values.md)
- [Run a people search](https://docs.fuseai.com/api-reference/prospect-search/run-a-people-search.md): Requires one of the following token scopes: search.
- [Save people-search results into a list](https://docs.fuseai.com/api-reference/prospect-search/save-people-search-results-into-a-list.md): Runs the search server-side from `filters` and saves up to `limit` matches into the destination list. Enrichment and saving run asynchronously: 202 means the job started, not that the list is populated.
- [List the token owner's saved searches](https://docs.fuseai.com/api-reference/saved-searches/list-the-token-owners-saved-searches.md): Requires one of the following token scopes: search.
- [Replay a saved search](https://docs.fuseai.com/api-reference/saved-searches/replay-a-saved-search.md): Requires one of the following token scopes: search.
- [Authentication](https://docs.fuseai.com/authentication.md): Create an API key and authenticate every request with HTTP Basic auth.
- [Credits & billing](https://docs.fuseai.com/concepts/credits.md): What debits credits, what never does, and how to avoid paying for the same search twice.
- [Errors](https://docs.fuseai.com/concepts/errors.md): The single error envelope, how to handle failures, and the complete code catalogue.
- [Pagination](https://docs.fuseai.com/concepts/pagination.md): How the Business API pages large collections: page numbers for stored data, scroll tokens for search.
- [Rate limits](https://docs.fuseai.com/concepts/rate-limits.md): How request quotas work, how to read the rate limit headers, and how to back off when you hit a 429
- [Scopes](https://docs.fuseai.com/concepts/scopes.md): Limit what an API key can do by scoping it to specific API surfaces
- [Build a list from search](https://docs.fuseai.com/guides/build-a-list-from-search.md): Turn a prospect search into a saved, enriched list: check filter values, preview cheaply, save once, and poll until the rows land.
- [Campaigns](https://docs.fuseai.com/guides/campaigns.md): Create a campaign from a list, review and edit its sequence steps, and approve it to start sending.
- [Custom columns](https://docs.fuseai.com/guides/custom-columns.md): Attach your own typed data — scores, owners, links, flags — to the contacts in a list
- [Export a list](https://docs.fuseai.com/guides/export-a-list.md): Download a list as a CSV with an async export job: start it, poll it, fetch the file
- [Knowledge hubs](https://docs.fuseai.com/guides/knowledge-hubs.md): Ground AI campaign generation in your company's own content.
- [Upload your own contacts](https://docs.fuseai.com/guides/upload-your-contacts.md): Bring contacts from your CRM into a Fuse list, and manage list membership by id.
- [Introduction](https://docs.fuseai.com/index.md): Programmatic access to Fuse: prospect search, lists, enrichment data, exports, and outbound campaigns.
- [Quickstart](https://docs.fuseai.com/quickstart.md): From API key to a populated, exported prospect list in five minutes.

## OpenAPI Specs

- [openapi](https://docs.fuseai.com/openapi.json)