> ## Documentation Index > Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an account number > Creates a new account number for one of your accounts, in the `live` or `test` mode of the API key used. Available only for Mexico account numbers, which are standardized Mexican bank account numbers (CLABEs). **`v2`** ยท Base URL `https://api.fintoc.com/v2` ## OpenAPI ````yaml reference/pacioli-api.json POST /account_numbers openapi: 3.1.0 info: title: Fintoc API version: v2026-02-01 servers: - url: https://api.fintoc.com/v2 security: [] paths: /account_numbers: post: tags: - Account numbers summary: Create an account number description: >- Creates a new account number for one of your accounts, in the `live` or `test` mode of the API key used. Available only for Mexico account numbers, which are standardized Mexican bank account numbers (CLABEs). operationId: account-numbers-create requestBody: content: application/json: schema: type: object properties: account_id: type: string description: Identifier of the account the new account number belongs to. example: acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA description: type: string description: Free-text description of the account number. example: Payouts CLABE metadata: type: object description: >- Set of key-value pairs you can attach to the account number for storing additional structured information. example: invoice_id: '12345' options: type: object description: Inbound transfer constraints for this account number. properties: min_amount: type: integer description: Minimum inbound amount, in the smallest currency unit. example: 1000 max_amount: type: integer description: Maximum inbound amount, in the smallest currency unit. example: 1000000 required: - account_id required: true responses: '200': description: The created account number. content: application/json: examples: account_number_created: value: id: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: account_number account_id: acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA created_at: '2026-03-01T12:00:00.000Z' deleted_at: null description: Payouts CLABE is_root: false last_transfer_at: null metadata: invoice_id: '12345' mode: test number: '646180111800000000' options: min_amount: 1000 max_amount: 1000000 status: enabled updated_at: '2026-03-01T12:00:00.000Z' schema: $ref: '#/components/schemas/account_number' '400': description: A required parameter is missing or invalid. content: application/json: examples: missing_parameter: value: error: code: missing_parameter message: 'Missing required param: account_id' param: account_id schema: $ref: '#/components/schemas/error_object' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '403': description: Account numbers are available only for Mexico organizations. content: application/json: examples: account_numbers_not_available: value: error: code: invalid_account message: >- Unable to create account number for account acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA. Action not available in your region schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: account_number: type: object properties: id: type: string description: Unique identifier of the account number. example: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: const: account_number description: Type of the object. Always `account_number`. account_id: type: string description: Identifier of the account this number belongs to. example: acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA created_at: type: string format: date-time description: Time the account number was created, as an ISO 8601 datetime in UTC. example: '2026-03-01T12:00:00.000Z' deleted_at: type: - string - 'null' description: >- Time the account number was deleted, as an ISO 8601 datetime in UTC, or `null` when not deleted. example: null description: type: - string - 'null' description: >- Free-text description of the account number, or `null` when none is set. example: Payouts CLABE is_root: type: boolean description: Whether this account number is the account's default. example: false last_transfer_at: type: - string - 'null' description: >- Time of the last transfer received, as an ISO 8601 datetime in UTC, or `null` when no transfer has been received. example: null metadata: type: object description: Set of key-value pairs attached to the account number. example: invoice_id: '12345' mode: type: string enum: - live - test description: Whether the account number holds `live` or `test` data. example: test number: type: string description: >- Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number. example: '646180111800000000' options: type: object description: Inbound transfer constraints for this account number. properties: min_amount: type: - integer - 'null' description: Minimum inbound amount, in the smallest currency unit. example: 1000 max_amount: type: - integer - 'null' description: Maximum inbound amount, in the smallest currency unit. example: 1000000 required: - min_amount - max_amount status: type: string enum: - enabled - disabled - blocked - deleted description: >- Current state of the account number. One of `enabled` (can receive inbound transfers), `disabled` (you turned off inbound transfers), `blocked` (Fintoc blocked inbound transfers), or `deleted` (removed; see `deleted_at`). example: enabled updated_at: type: string format: date-time description: >- Time the account number was last updated, as an ISO 8601 datetime in UTC. example: '2026-03-01T12:00:00.000Z' required: - id - object - account_id - created_at - deleted_at - description - is_root - last_transfer_at - metadata - mode - number - options - status - updated_at error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_request`. example: invalid_request doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Missing required param: account_id' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. Not returned by every error. example: account_id type: type: string description: >- Category of the error, for example `invalid_request_error` or `authentication_error`. Not returned by every error. example: invalid_request_error required: - code - message required: - error securitySchemes: api_key: type: apiKey name: Authorization in: header ````