> ## Documentation Index > Fetch the complete documentation index at: https://docs.qonto.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an internal transfer > OAuth scope: `internal_transfer.write` Creates a single instant transfer between 2 bank accounts of the authenticated organization. You can obtain the bank accounts' IBAN through the [GET /v2/organization](/api-reference/business-api/accounts-organizations/organizations/retrieve-the-authenticated-organization-and-list-bank-accounts) endpoint. ## OpenAPI ````yaml post /v2/internal_transfers openapi: 3.1.1 info: version: v2 title: Qonto servers: - url: https://thirdparty.qonto.com description: Production URL - url: https://thirdparty-sandbox.staging.qonto.co description: Sandbox URL security: - OAuth: - organization.read - membership.read - membership.write - attachment.write - internal_transfer.write - payment.write - supplier_invoice.write - supplier_invoice.read - client_invoices.read - client_invoice.write - client.read - client.write - product.read - product.write - request_review.write - request_review.read - team.read - team.write - request_transfers.write - insurance_contract.read - insurance_contract.write - card.read - card.write - bank_account.write - beneficiary.trust - webhook - payment_link.write - payment_link.read - sepa_direct_debit.read - sepa_direct_debit.write - terminal.read - terminal.write - SecretKey: [] paths: /v2/internal_transfers: post: tags: - Internal Transfers summary: Create an internal transfer description: >- OAuth scope: `internal_transfer.write` Creates a single instant transfer between 2 bank accounts of the authenticated organization. You can obtain the bank accounts' IBAN through the [GET /v2/organization](/api-reference/business-api/accounts-organizations/organizations/retrieve-the-authenticated-organization-and-list-bank-accounts) endpoint. parameters: - $ref: '#/components/parameters/X-Qonto-Idempotency-Key' - $ref: '#/components/parameters/X-Qonto-Staging-Token' requestBody: content: application/json: schema: type: object properties: internal_transfer: type: object properties: debit_iban: type: string description: IBAN of account to debit. credit_iban: type: string description: IBAN of account to credit. reference: type: string description: >- Can be used to enter transfer details to further describe the transfer. Maximum `reference` length is `99` characters. amount: type: string description: >- Corresponds to the amount of the transaction in the `currency` of the bank account. Amounts must be https://www.w3.org/TR/payment-request/#dfn-valid-decimal-monetary-value. currency: type: string description: Only accepts "EUR". required: - debit_iban - credit_iban - reference - amount - currency required: - internal_transfer examples: default: value: internal_transfer: debit_iban: IT12M3609201600032486198434 credit_iban: IT13M3609201600032486198435 reference: Internal transfer amount: '12345.67' currency: EUR responses: '200': description: Returns the internal transfer created. content: application/json: schema: type: object properties: internal_transfer: $ref: '#/components/schemas/InternalTransfer' examples: default: value: internal_transfer: id: 0ded2767-f44d-48b4-9e98-b8b6d9359c07 slug: yottanet-6666-1-transfer-52 status: pending amount: 12.33 amount_cents: 1233 currency: EUR reference: Internal transfer created_at: '2021-05-11T10:22:55.090Z' '400': $ref: '#/components/responses/400-Bad-request' '401': $ref: '#/components/responses/401-Unauthorized' '403': $ref: '#/components/responses/403-Forbidden' '422': $ref: '#/components/responses/422-Unprocessable-Entity' '500': $ref: '#/components/responses/500-Internal-Server-Error' security: - OAuth: - internal_transfer.write - SecretKey: [] components: parameters: X-Qonto-Idempotency-Key: name: X-Qonto-Idempotency-Key in: header required: true description: >- Learn more in [Idempotent Requests](/get-started/general/idempotent-requests). schema: type: string example: 123e4567-e89b-12d3-a456-426614174000 X-Qonto-Staging-Token: name: X-Qonto-Staging-Token in: header description: >- Required only for Sandbox API requests; to get one, please sign up to the [Developer Portal](https://developers.qonto.com/). schema: type: string schemas: InternalTransfer: type: object properties: id: type: string description: Transfer ID slug: type: string description: Transfer slug status: type: string description: Transfer status (always pending) amount: type: number description: Transfer amount amount_cents: type: integer description: Transfer amount in cents currency: type: string description: Transfer currency (EUR only) reference: type: string description: Transfer reference created_at: type: string description: Transfer creation time BadRequestResponseBody: type: object properties: errors: type: array items: $ref: '#/components/schemas/BadRequestError' required: - errors UnauthorizedResponseBody: type: object properties: errors: type: array items: $ref: '#/components/schemas/UnauthorizedError' required: - errors ForbiddenResponseBody: type: object properties: errors: type: array items: $ref: '#/components/schemas/ForbiddenError' required: - errors UnprocessableEntityError: type: object properties: status: type: string example: unprocessable entity code: type: string description: Error code. example: missing_key detail: type: string description: Human readable error that explains error `code`. example: property is missing message: type: string example: property id is missing source: type: object properties: pointer: type: string description: >- The property and the item in an array (if applicable) that causes the error. example: id required: - code - detail x-examples: Missing property: code: missing_key detail: property is missing source: pointer: /external_transfer/atrribute BadRequestError: type: object properties: code: type: string description: Error code. detail: type: string description: Human readable error that explains error `code`. source: type: object properties: pointer: type: string description: >- The property in the request body that caused the error (optional). parameter: type: string description: The query parameter that caused the error (optional). required: - code - detail x-examples: Authorization field missing: code: bad_request detail: Authorization field missing UnauthorizedError: type: object properties: code: type: string description: Error code. detail: type: string description: Human readable error that explains error `code`. required: - code - detail x-examples: Invalid credentials: code: unauthorized detail: Invalid credentials ForbiddenError: type: object properties: code: type: string description: Error code. detail: type: string description: Human readable error that explains error `code`. required: - code - detail x-examples: Insufficient permissions: code: forbidden detail: User does not have sufficient permissions for this action. responses: 400-Bad-request: description: Returns a bad request error. content: application/json: schema: $ref: '#/components/schemas/BadRequestResponseBody' examples: Authorization field missing: value: errors: - code: bad_request detail: Authorization field missing 401-Unauthorized: description: Returns an unauthorized error. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponseBody' examples: authorization_header_missing: value: errors: - code: authorization_header_missing detail: authorization header missing authorization_token_invalid: value: errors: - code: authorization_token_invalid detail: authorization token invalid 403-Forbidden: description: Returns a forbidden error. content: application/json: schema: $ref: '#/components/schemas/ForbiddenResponseBody' examples: Insufficient permissions: value: errors: - code: forbidden detail: User does not have sufficient permissions for this action. 422-Unprocessable-Entity: description: Returns an unprocessable entity error. content: application/json: schema: type: object properties: errors: type: array items: $ref: '#/components/schemas/UnprocessableEntityError' x-examples: Example 1: errors: - code: missing_key detail: reference is missing source: pointer: /external_transfer/reference 500-Internal-Server-Error: description: Returns an internal server error. securitySchemes: OAuth: type: oauth2 description: > Bearer authorization header: `Bearer `, where `` is the access token received from the authorization server at the end of the [OAuth 2.0 flow](/get-started/business-api/authentication/oauth/oauth-flow). flows: authorizationCode: refreshUrl: https://oauth.qonto.com/oauth2/token authorizationUrl: https://oauth.qonto.com/oauth2/auth scopes: attachment.read: Retrieve attachments attachment.write: Upload attachments and remove attachments from transactions bank_account.write: Create, update and close bank accounts beneficiary.trust: Trust SEPA beneficiaries card.read: Retrieve cards card.write: Create or update cards client.read: Retrieve clients client.write: Create clients client_invoice.write: Create client invoices client_invoices.read: Retrieve client invoices and credit notes einvoicing.read: Retrieve e-invoicing settings embed_auth_link.write: Create Embed auth links insurance_contract.read: Retrieve insurance contracts insurance_contract.write: Create and update insurance contracts internal_transfer.write: >- Create internal transfers (between 2 Qonto accounts of the same organization) international_transfer.write: Create international transfers membership.read: Retrieve the authentified membership membership.write: Invite team members offline_access: Retrieve a refresh token organization.read: >- Retrieve organization, bank accounts, transactions, transfers, beneficiaries, labels, memberships, requests & statements payment.write: Create external transfers and untrust beneficiaries payment_link.read: >- Retrieve payment links, their payments, and the available payment methods payment_link.write: >- Connect to the payment links provider, create and deactivate payment links product.read: Retrieve products product.write: Create products request_cards.write: Create card requests request_review.write: Approve or decline requests request_transfers.write: Create transfer requests sepa_direct_debit.read: View SEPA Direct Debit payments sepa_direct_debit.write: Manage SEPA Direct Debit payments supplier_invoice.read: Retrieve supplier invoices supplier_invoice.write: Create supplier invoices team.read: Retrieve teams team.write: Create teams terminal.read: View your payment terminals terminal.write: Configure your terminals and initiate payments webhook: >- Receive a notification each time a particular event occurs in Qonto tokenUrl: https://oauth.qonto.com/oauth2/token SecretKey: type: apiKey description: cf. [API key](/get-started/business-api/authentication/api-key) name: Authorization in: header ````