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

# Create a transfer

> Creates a new transfer.



## OpenAPI

````yaml POST /quickbooks-desktop/transfers
openapi: 3.1.0
info:
  title: Conductor API
  version: 0.0.1
servers:
  - url: https://api.conductor.is/v1
security:
  - BearerAuth: []
paths:
  /quickbooks-desktop/transfers:
    post:
      summary: Create a transfer
      description: Creates a new transfer.
      parameters:
        - in: header
          name: Conductor-End-User-Id
          description: The ID of the End-User to receive this request.
          schema:
            type: string
            description: The ID of the End-User to receive this request.
            example: end_usr_1234567abcdefg
            x-stainless-naming:
              typescript:
                method_argument: conductorEndUserId
              mcp:
                method_argument: conductorEndUserId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                transactionDate:
                  type: string
                  format: date
                  description: The date of this transfer, in ISO 8601 format (YYYY-MM-DD).
                  example: '2024-10-01'
                sourceAccountId:
                  type: string
                  description: The account from which money will be transferred.
                  example: 80000001-1234567890
                targetAccountId:
                  type: string
                  description: The account to which money will be transferred.
                  example: 80000001-1234567890
                classId:
                  type: string
                  description: >-
                    The transfer's class. Classes can be used to categorize
                    objects into meaningful segments, such as department,
                    location, or type of work. In QuickBooks, class tracking is
                    off by default.
                  example: 80000001-1234567890
                amount:
                  type: string
                  description: >-
                    The monetary amount of this transfer, represented as a
                    decimal string.
                  example: '1000.00'
                memo:
                  type: string
                  description: A memo or note for this transfer.
                  example: Monthly transfer to savings
              required:
                - transactionDate
                - sourceAccountId
                - targetAccountId
                - amount
              additionalProperties: false
      responses:
        '200':
          description: Returns the newly created transfer.
          headers:
            Conductor-Request-Id:
              schema:
                type: string
                description: The unique identifier for this API request.
                example: req_1234567abcdefg
              required: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/qbd_transfer'
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import Conductor from 'conductor-node';

            const conductor = new Conductor({
              apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
            });

            const transfer = await conductor.qbd.transfers.create({
              amount: '1000.00',
              sourceAccountId: '80000001-1234567890',
              targetAccountId: '80000001-1234567890',
              transactionDate: '2024-10-01',
              conductorEndUserId: 'end_usr_1234567abcdefg',
            });

            console.log(transfer.id);
        - lang: Python
          source: |-
            import os
            from datetime import date
            from conductor import Conductor

            conductor = Conductor(
                api_key=os.environ.get("CONDUCTOR_SECRET_KEY"),  # This is the default and can be omitted
            )
            transfer = conductor.qbd.transfers.create(
                amount="1000.00",
                source_account_id="80000001-1234567890",
                target_account_id="80000001-1234567890",
                transaction_date=date.fromisoformat("2024-10-01"),
                conductor_end_user_id="end_usr_1234567abcdefg",
            )
            print(transfer.id)
components:
  schemas:
    qbd_transfer:
      type: object
      properties:
        id:
          type: string
          description: >-
            The unique identifier assigned by QuickBooks to this transfer. This
            ID is unique across all transaction types.
          example: 123ABC-1234567890
        objectType:
          type: string
          const: qbd_transfer
          description: The type of object. This value is always `"qbd_transfer"`.
          example: qbd_transfer
        createdAt:
          type: string
          description: >-
            The date and time when this transfer was created, in ISO 8601 format
            (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in
            the local timezone of the end-user's computer.
          example: '2025-01-01T12:34:56.000Z'
        updatedAt:
          type: string
          description: >-
            The date and time when this transfer was last updated, in ISO 8601
            format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop
            interprets in the local timezone of the end-user's computer.
          example: '2025-02-01T12:34:56.000Z'
        revisionNumber:
          type: string
          description: >-
            The current QuickBooks-assigned revision number of this transfer
            object, which changes each time the object is modified. When
            updating this object, you must provide the most recent
            `revisionNumber` to ensure you're working with the latest data;
            otherwise, the update will return an error.
          example: '1721172183'
        transactionDate:
          type: string
          format: date
          description: The date of this transfer, in ISO 8601 format (YYYY-MM-DD).
          example: '2024-10-01'
        sourceAccount:
          type: object
          properties:
            id:
              type:
                - string
                - 'null'
              description: >-
                The unique identifier assigned by QuickBooks to this object.
                This ID is unique across all objects of the same type, but not
                across different QuickBooks object types.
              example: 80000001-1234567890
            fullName:
              type:
                - string
                - 'null'
              description: >-
                The fully-qualified unique name for this object, formed by
                combining the names of its parent objects with its own `name`,
                separated by colons. Not case-sensitive.
              example: Parent:Child:Grandchild
          required:
            - id
            - fullName
          additionalProperties: false
          description: The account from which money will be transferred.
          example:
            id: 80000001-1234567890
            fullName: Checking
        sourceAccountBalance:
          type:
            - string
            - 'null'
          description: The balance of the account from which money will be transferred.
          example: '1000.00'
        targetAccount:
          type: object
          properties:
            id:
              type:
                - string
                - 'null'
              description: >-
                The unique identifier assigned by QuickBooks to this object.
                This ID is unique across all objects of the same type, but not
                across different QuickBooks object types.
              example: 80000001-1234567890
            fullName:
              type:
                - string
                - 'null'
              description: >-
                The fully-qualified unique name for this object, formed by
                combining the names of its parent objects with its own `name`,
                separated by colons. Not case-sensitive.
              example: Parent:Child:Grandchild
          required:
            - id
            - fullName
          additionalProperties: false
          description: The account to which money will be transferred.
          example:
            id: 80000001-1234567890
            fullName: Savings
        targetAccountBalance:
          type:
            - string
            - 'null'
          description: The balance of the account to which money will be transferred.
          example: '5000.00'
        class:
          type:
            - object
            - 'null'
          properties:
            id:
              type:
                - string
                - 'null'
              description: >-
                The unique identifier assigned by QuickBooks to this object.
                This ID is unique across all objects of the same type, but not
                across different QuickBooks object types.
              example: 80000001-1234567890
            fullName:
              type:
                - string
                - 'null'
              description: >-
                The fully-qualified unique name for this object, formed by
                combining the names of its parent objects with its own `name`,
                separated by colons. Not case-sensitive.
              example: Parent:Child:Grandchild
          required:
            - id
            - fullName
          additionalProperties: false
          description: >-
            The transfer's class. Classes can be used to categorize objects into
            meaningful segments, such as department, location, or type of work.
            In QuickBooks, class tracking is off by default.
          example:
            id: 80000001-1234567890
            fullName: Inter Departmental
        amount:
          type: string
          description: >-
            The monetary amount of this transfer, represented as a decimal
            string.
          example: '1000.00'
        memo:
          type:
            - string
            - 'null'
          description: A memo or note for this transfer.
          example: Monthly transfer to savings
      required:
        - id
        - objectType
        - createdAt
        - updatedAt
        - revisionNumber
        - transactionDate
        - sourceAccount
        - sourceAccountBalance
        - targetAccount
        - targetAccountBalance
        - class
        - amount
        - memo
      additionalProperties: false
      title: The Transfer object
      x-conductor-object-type: transaction
      summary: >-
        A transfer records the movement of funds between two accounts in
        QuickBooks Desktop. It reduces the balance of one account (the "from"
        account) and increases the balance of another account (the "to" account)
        by the same amount. Transfers are commonly used for moving money between
        bank accounts or recording internal fund movements.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your Conductor secret key using Bearer auth (e.g., `"Authorization:
        Bearer {{YOUR_SECRET_KEY}}"`).

````

Built with [Mintlify](https://mintlify.com).