> ## Documentation Index > Fetch the complete documentation index at: https://docs.truust.io/llms.txt > Use this file to discover all available pages before exploring further. # Create Account > Registers a new merchant account and its associated manager. ## OpenAPI ````yaml POST /accounts openapi: 3.1.0 info: title: Truust API version: '2.0' description: > The Truust API allows you to manage payment flows, orders, customers, wallets, and more. ## Authentication All authenticated endpoints require a Bearer token using your account's **Secret Key**. ``` Authorization: Bearer {your_secret_key} ``` Your API keys are available in the Dashboard under **Account Settings → API Developers**. contact: email: hello@truust.io license: name: Proprietary servers: - url: https://{subdomain}.truust.io/2.0 description: Production variables: subdomain: default: your-subdomain description: Your account subdomain - url: https://{subdomain}-sandbox.truust.io/2.0 description: Sandbox variables: subdomain: default: your-subdomain description: Your account subdomain security: - bearerAuth: [] tags: - name: Account description: Manage your Truust account - name: Customers description: Manage buyers and sellers (end users) - name: Orders description: Create and manage escrow payment orders - name: Payins description: Manage incoming payments for orders - name: Payouts description: Manage outgoing payments from orders - name: Wallets description: Manage customer and account wallets - name: Bank Accounts description: Manage bank accounts for payouts - name: Cards description: Manage tokenized payment cards - name: Subscriptions description: Manage recurring payment subscriptions - name: Verifications description: KYC verification for customers and accounts - name: Bundles description: Manage product bundles for orders - name: Refunds description: View refund records paths: /accounts: post: tags: - Account summary: Create account description: Registers a new merchant account and its associated manager. operationId: createAccount requestBody: required: true content: application/json: schema: type: object required: - name - slug - country_code - email - password example: name: My Company slug: my_company country_code: ES email: owner@mycompany.com password: Str0ng!Pass locale: es properties: name: type: string maxLength: 255 description: Unique business name. example: My Company slug: type: string description: >- Unique slugged name derived from `name` (e.g. "My Account" → "my_account"). example: my_company country_code: type: string maxLength: 2 description: ISO 3166-1 alpha-2 country code. example: ES email: type: string format: email maxLength: 255 example: owner@mycompany.com password: type: string minLength: 8 maxLength: 255 description: Strong password (lower + upper case + symbol + number). example: Str0ng!Pass image: type: string description: Base64-encoded image or URL for the account logo. locale: type: string description: >- Notifications will be sent in this language (e.g. `es`, `en`). example: es business_url: type: string description: URL of the business. product_description: type: string description: Description of the product or service. fee_percent: type: number description: Fee applied to orders (including platform's fee). fee_amount: type: number description: Fixed fee applied to orders (including platform's fee). fee_platform_percent: type: number description: Platform fee percentage applied to orders. fee_platform_amount: type: number description: Fixed platform fee applied to orders. fee_credit: type: number description: Credit fee applied to orders (including platform's fee). fee_shipping_1: type: number description: Shipping fee for small-sized packages. fee_shipping_2: type: number description: Shipping fee for medium-sized packages. fee_shipping_3: type: number description: Shipping fee for large-sized packages. default_parcel_size: type: string description: Default parcel size. default_fee: type: number description: Default fee. default_gateway: type: string description: Default payment gateway. enum: - ADDON - ADDON_V2 - ADDON_ICE - ADDON_HPP - ADDON_APPLE_PAY - AZUPAY - BANKWIRE - WALLET - DCP - EPX - REDSYS_V2 - REDSYS_APPLE_PAY - REDSYS_AUTH - STRIPE - DOCOMO - SIBS_MBWAY - SIBS_MULTIBANCO - SEQURA - UNNAX - PAYPAL - BIZUM - INESPAY allowed_gateways: type: array items: type: string description: List of allowed gateways besides the default gateway. template_folder: type: string description: Template folder for the Checkout. custom_domain: type: string description: Custom domain URL. allow_insurance: type: integer enum: - 0 - 1 description: Allow orders to have an insurance option. allow_shipping: type: integer enum: - 0 - 1 description: Allow orders to have a shipping option. allow_select_parcel: type: integer enum: - 0 - 1 description: Allow the seller to select the parcel size. allow_receipt: type: integer enum: - 0 - 1 description: Allow sending a receipt when a payment is performed. allow_receipt_self: type: integer enum: - 0 - 1 description: >- Allow receiving a receipt in the account email when a payment is performed. billing_address: type: string description: Company's billing address. billing_address_line_2: type: string description: Company's billing address line 2. billing_city: type: string billing_state: type: string billing_zip: type: string billing_country: type: string maxLength: 2 vat_id: type: string description: Company's VAT identification number. extra_billing_information: type: string description: Extra billing information. legal_address: type: string description: Company's legal address. legal_address_line_2: type: string legal_city: type: string legal_state: type: string legal_zip: type: string legal_country: type: string maxLength: 2 representative_name: type: string description: Name of the company's representative. representative_phone: type: string description: Phone of the company's representative. representative_email: type: string format: email description: Email of the company's representative. twitter_token: type: string description: Twitter credentials to share orders. twitter_secret: type: string description: Twitter credentials to share orders. facebook_id: type: string description: Facebook credentials to share orders. facebook_token: type: string description: Facebook credentials to share orders. parent_id: type: integer description: Parent account ID. Only for subaccounts. addon_key: type: string description: Payment gateway credential. addon_secret: type: string description: Payment gateway credential. addon_account: type: string description: Payment gateway credential. addon_rebate: type: string description: Payment gateway credential. psd2_enabled: type: integer enum: - 0 - 1 description: Whether the account is PSD2 enabled. receipt_subject: type: string description: >- Subject of the email sent to the customer (selected pricing plans only). receipt_message: type: string description: >- Message of the email sent to the customer (selected pricing plans only). payment_success_message: type: string description: >- Message shown to customers on successful payment (selected pricing plans only). responses: '200': description: Account created content: application/json: schema: $ref: '#/components/schemas/Account' '422': $ref: '#/components/responses/ValidationError' security: [] components: schemas: Account: type: object properties: self: type: string example: /2.0/accounts/me merchant_id: type: string description: Unique merchant identifier (addon_key). name: type: string example: My Company email: type: string format: email currency: type: string example: EUR country_code: type: string example: ES business_url: type: string nullable: true business_phone: type: string nullable: true business_description: type: string nullable: true image_url: type: string nullable: true public_key: type: string secret_key: type: string description: Secret API key. Only visible to the account owner. allow_shipping: type: integer enum: - 0 - 1 value_shipping: type: number is_active: type: boolean psd2_enabled: type: integer enum: - 0 - 1 allowed_gateways: type: array items: type: string gateways: type: array nullable: true items: type: object additionalProperties: true description: List of configured payment gateway objects for the account. default_gateway: type: string nullable: true created_at: type: string format: date-time nullable: true responses: ValidationError: description: Validation error content: application/json: schema: type: object properties: message: type: string example: The given data was invalid. errors: type: object additionalProperties: type: array items: type: string example: name: - The name field is required. securitySchemes: bearerAuth: type: http scheme: bearer description: Use your account's **Secret Key** as the Bearer token. ````