> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesfinity.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Custom Fields

> Returns all custom field mappings configured for the team. Custom fields represent field mappings between Salesfinity and integrated CRM platforms.

Returns all custom field mappings configured for your team. Custom fields represent field mappings between Salesfinity and your integrated CRM platforms (Salesforce, HubSpot, etc.).

Each record contains the integration source and the mapped fields for contacts and leads.

### Response

Returns an array of custom field mapping records.

* `_id` - Unique identifier
* `source` - Integration source (e.g. `salesforce`, `hubspot`)
* `team` - Team ID
* `user` - User ID who configured the mapping
* `fields` - Array of contact field mappings
  * `type` - Field category
  * `field_type` - Data type of the field
  * `internal_name` - Salesfinity field name
  * `external_key` - CRM field key
  * `external_name` - CRM field display name
* `lead_fields` - Array of lead field mappings (same structure as `fields`)
* `createdAt` - Creation timestamp
* `updatedAt` - Last update timestamp


## OpenAPI

````yaml GET /v1/custom-fields
openapi: 3.0.1
info:
  title: Salesfinity API
  description: API documentation for Salesfinity platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://client-api.salesfinity.co
security:
  - ApiKeyAuth: []
paths:
  /v1/custom-fields:
    get:
      tags:
        - Custom Fields
      description: >-
        Returns all custom field mappings configured for the team. Custom fields
        represent field mappings between Salesfinity and integrated CRM
        platforms.
      operationId: get-custom-fields
      responses:
        '200':
          description: Custom fields retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CustomFieldsDTO'
components:
  schemas:
    CustomFieldsDTO:
      type: object
      properties:
        _id:
          type: string
          description: Unique identifier
        source:
          type: string
          enum:
            - csv
            - salesforce
            - salesloft
            - outreach
            - apollo
            - hubspot
            - active-campaign
            - custom
            - pipe-drive
            - monday
          description: Integration source
        team:
          type: string
          description: Team ID
        user:
          type: string
          description: User ID
        fields:
          type: array
          items:
            $ref: '#/components/schemas/CustomFieldDTO'
          description: Contact field mappings
        lead_fields:
          type: array
          items:
            $ref: '#/components/schemas/CustomFieldDTO'
          description: Lead field mappings
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - _id
        - source
        - team
    CustomFieldDTO:
      type: object
      properties:
        type:
          type: string
          description: Field category
        field_type:
          type: string
          description: Data type of the field
        internal_name:
          type: string
          description: Salesfinity field name
        external_key:
          type: string
          description: CRM field key
        external_name:
          type: string
          description: CRM field display name
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````