> ## 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. In Mexico, Fintoc generates 18-digit standardized Mexican bank account numbers (CLABEs) for you. In Chile, Fintoc generates the account number for you. ## OpenAPI ````yaml reference/core-api.json POST /v2/account_numbers openapi: 3.1.0 info: title: Fintoc API version: v2026-02-01 servers: - url: https://api.fintoc.com security: [] paths: /v2/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. In Mexico, Fintoc generates 18-digit standardized Mexican bank account numbers (CLABEs) for you. In Chile, Fintoc generates the account number for you. 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. Up to 50 pairs, with keys of up to 40 characters and string values of up to 500 characters. Values cannot be arrays or nested objects. example: invoice_id: '12345' options: type: object description: >- Inbound transfer amount limits for this account number. Currently available for Mexico account numbers only. properties: min_amount: type: integer description: >- Minimum inbound amount, in the smallest currency unit. Ranges from `0` to `max_amount`. example: 1000 max_amount: type: integer description: >- Maximum inbound amount, in the smallest currency unit. The minimum is `1`. example: 1000000 required: - account_id required: true responses: '200': description: The created account number. content: application/json: examples: mx_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: '646180111800000004' options: min_amount: 1000 max_amount: 1000000 status: enabled updated_at: '2026-03-01T12:00:00.000Z' cl_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 account number is_root: false last_transfer_at: null metadata: invoice_id: '12345' mode: test number: '123456789' options: min_amount: null max_amount: null 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: The account is not active. content: application/json: examples: account_not_active: value: error: code: account_not_active message: Account acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA not active 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: '646180111800000004' options: type: object description: >- Inbound transfer amount limits for this account number. Currently available for Mexico account numbers only. 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 ````