> ## Documentation Index > Fetch the complete documentation index at: https://docs.fuseai.com/llms.txt > Use this file to discover all available pages before exploring further. # Push a list's contacts into a connected CRM > Pushes the list's contacts into a connected CRM. `crm` names which one (`hubspot`, `salesforce`, `zoho`, `attio`, `pipedrive`; several can be connected at once); the connection checked is the team's designated sync user's, so an unconnected CRM answers 422 CRM_NOT_CONNECTED. An explicit `contactIds` selection pushes just those contacts (the response still echoes the list id). Async, with no job to poll: the sync runs in the background against the field mapping saved in the app's CRM settings, and results appear in the CRM. No credits are spent. Errors: - `404` `LIST_NOT_FOUND` — No list with that id is visible to the token owner. - `422` `CONTACT_LIST_REQUIRED` — The list is a company list; the push sends contacts. - `422` `CRM_NOT_CONNECTED` — The team's sync user has no live connection to that CRM. - `422` `VALIDATION_FAILED` — crm missing or outside the supported set, or contactIds outside 1-500. - `429` `RATE_LIMITED` — The lists rate bucket (120 requests/minute, 10,000/day per token owner) is exhausted. Requires one of the following token scopes: lists. ## OpenAPI ````yaml /openapi.json post /business/lists/{listId}/crm-push openapi: 3.1.0 info: title: Fuse Business API version: 1.0.0 description: >- External API for lists, campaigns, prospect search and contacts. Authenticate with your API token as HTTP Basic. All paths are under /api/v1. servers: - url: https://api.tryfuse.ai/api/v1 description: Production security: - basicAuth: [] tags: - name: Lists - name: Custom columns - name: Smart columns - name: Exports - name: Campaigns - name: Knowledge hubs - name: Analytics - name: Website intent - name: Account - name: Prospect search - name: Campaign steps - name: Scheduled sends - name: Campaign templates - name: Agents - name: Research - name: Company search - name: Saved searches - name: Folders - name: Contacts paths: /business/lists/{listId}/crm-push: post: tags: - Lists summary: Push a list's contacts into a connected CRM description: >- Pushes the list's contacts into a connected CRM. `crm` names which one (`hubspot`, `salesforce`, `zoho`, `attio`, `pipedrive`; several can be connected at once); the connection checked is the team's designated sync user's, so an unconnected CRM answers 422 CRM_NOT_CONNECTED. An explicit `contactIds` selection pushes just those contacts (the response still echoes the list id). Async, with no job to poll: the sync runs in the background against the field mapping saved in the app's CRM settings, and results appear in the CRM. No credits are spent. Errors: - `404` `LIST_NOT_FOUND` — No list with that id is visible to the token owner. - `422` `CONTACT_LIST_REQUIRED` — The list is a company list; the push sends contacts. - `422` `CRM_NOT_CONNECTED` — The team's sync user has no live connection to that CRM. - `422` `VALIDATION_FAILED` — crm missing or outside the supported set, or contactIds outside 1-500. - `429` `RATE_LIMITED` — The lists rate bucket (120 requests/minute, 10,000/day per token owner) is exhausted. Requires one of the following token scopes: lists. operationId: pushListToCrm parameters: - name: listId in: path required: true description: 24-character hex id of the list (from GET /business/lists). schema: type: string description: 24-character hex id of the list (from GET /business/lists). requestBody: required: true content: application/json: schema: type: object properties: crm: type: string enum: - hubspot - salesforce - zoho - attio - pipedrive description: >- Which connected CRM receives the contacts: hubspot, salesforce, zoho, attio or pipedrive; an unconnected CRM answers 422 CRM_NOT_CONNECTED. contactIds: type: array items: type: string description: >- 24-character hex id of a contact (the row id from GET /business/lists/{listId}/rows). minItems: 1 maxItems: 500 description: >- Push only these contacts (24-character hex ids, at most 500) instead of every contact in the list: the ids are the selection, so every one of them is pushed and nothing else is. They are taken as given rather than intersected with the list, and sending them also makes the push overwrite fields on records that already exist in the CRM — pushing the whole list leaves those untouched. required: - crm responses: '202': description: Success headers: RateLimit-Limit: schema: type: integer description: Requests permitted in the current window. RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. RateLimit-Reset: schema: type: integer description: Seconds until the current window resets. content: application/json: schema: type: object required: - crm - listIds properties: crm: type: string enum: - hubspot - salesforce - zoho - attio - pipedrive listIds: type: array items: type: string example: crm: hubspot listIds: - 68a1f20b9c41d20014b3e901 '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' security: - basicAuth: [] components: schemas: Error: type: object properties: error: type: object properties: code: type: string message: type: string param: type: - string - 'null' doc_url: type: - string - 'null' request_id: type: - string - 'null' required: - code - message required: - error securitySchemes: basicAuth: type: http scheme: basic description: >- Your API token (`af_…`) as the Basic-auth username, with an empty password. ````