> ## Documentation Index > Fetch the complete documentation index at: https://developer.meow.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a business entity > Creates a new business entity owned by your API key's user. Send an empty body to create a bare not-started entity, or seed any KYB business details up front: legal name, incorporation, the registered legal and (optional) physical address, and the business profile fields (phone, tax ID, website, description, industry, account purpose, and digital-currency questions). The creating user is granted admin on the new entity, so the same API key can immediately act on it by passing the returned entity ID in the `x-entity-id` header. Anything you omit can be added later with Update Business Details. The entity still completes KYB (beneficial owners and any remaining details) before it can be approved or open bank accounts. ## OpenAPI ````yaml POST /entities openapi: 3.1.0 info: title: Meow API description: > ## Overview The Meow API provides financial services and billing capabilities for your business. ### Core Features - **Financial data access**: access account information, transactions, balances, and payment networks. - **Crypto operations**: create and manage crypto contacts, and initiate USDC transfers across blockchain networks. ### Billing API The Billing API lets you create and manage invoices and collect payments: - **Product management**: create and manage products with custom pricing. - **Customer management**: maintain invoicing customers with their addresses. - **Invoice creation**: generate invoices with line items, discounts, and custom notes. - **Payment options**: accept payments via ACH, wire, international wire, card, and USDC. - **Collection accounts**: configure accounts for payment collection. ### Getting Started Authenticate by sending your API key in the `x-api-key` request header. To scope requests to a specific entity, include the `x-entity-id` header. Use the `/api-keys/accessible-entities` endpoint to list all entities accessible by your API key. ### Error Responses Errors return JSON with `code`, `message`, and `debug_message`. The `code` aligns with FDX where possible; use `debug_message` for troubleshooting only. Common error codes: - `500`: Internal server error - `501`: Subsystem unavailable - `503`: Scheduled maintenance - `601`: Data not found - `602`: Customer not authorized - `701`: Account not found - `703`: Invalid input (including invalid date ranges) - `704`: Account type not supported - `705`: Account is closed - `801`: Transaction not found contact: name: Meow url: https://meow.com/ email: support@meow.com version: 1.0.0 license: name: Proprietary url: https://www.meow.com/terms-of-service servers: - url: https://api.meow.com/v1 description: Meow API Production - url: https://api.sandbox.meow.com/v1 description: Meow API Sandbox security: - apiKeyAuth: [] tags: - name: API Keys description: Retrieve metadata about API keys and their accessible entities. - name: Accounts description: Access and manage accounts. - name: Approvals - name: Balances description: Retrieve account balances and available funds. - name: Bills description: View and manage bills for vendor payments. - name: Cards description: Manage virtual and physical cards, and view transactions and insights. - name: Collection Accounts description: Manage accounts for payment collection. - name: Contacts description: Manage contacts for crypto and USDC transfers. - name: Customers description: Manage invoicing customers and their details. - name: Entities - name: Invoices description: Create and manage invoices. - name: Limits - name: Line Items description: Manage invoice line items. - name: Partner Onboarding description: Onboard entities using your partner API key. - name: Partner Webhooks - name: Payment Methods description: View available payment method types. - name: Payment Networks description: Manage payment networks and routing information. - name: Products description: Manage products and pricing for invoicing. - name: Routing Numbers description: Validate routing numbers and retrieve bank information. - name: Security Policies - name: Simulations description: >- Trigger simulated events — inbound transfers, card authorizations, application approval — to test integrations end-to-end without real money movement. **Not available in production**: these endpoints exist only in sandbox and development environments and return `404 Not Found` in production. - name: Tax Forms description: Retrieve IRS tax forms (1099 family) issued for accounts. - name: Transactions description: Retrieve account transaction history and details. - name: Transfers description: >- Initiate ACH, wire, book, and crypto transfers, and retrieve transfer details. - name: Webhooks description: Manage webhook subscriptions and inspect delivery history. paths: /entities: post: tags: - Entities summary: Create Business Entity description: >- Creates a new business entity owned by your API key's user. Send an empty body to create a bare not-started entity, or seed any KYB business details up front: legal name, incorporation, the registered legal and (optional) physical address, and the business profile fields (phone, tax ID, website, description, industry, account purpose, and digital-currency questions). The creating user is granted admin on the new entity, so the same API key can immediately act on it by passing the returned entity ID in the `x-entity-id` header. Anything you omit can be added later with Update Business Details. The entity still completes KYB (beneficial owners and any remaining details) before it can be approved or open bank accounts. operationId: create_business_entity_entities_post requestBody: content: application/json: schema: anyOf: - $ref: '#/components/schemas/CreateBusinessEntityRequest' - type: 'null' title: Request responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CreateBusinessEntityResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - entity:create components: schemas: CreateBusinessEntityRequest: properties: business_phone: anyOf: - type: string maxLength: 20 minLength: 10 - type: 'null' title: Business Phone description: Business phone number. examples: - '+14155550123' business_taxid: anyOf: - type: string maxLength: 50 minLength: 0 - type: 'null' title: Business Taxid description: Business tax ID (EIN). examples: - 12-3456789 business_website: anyOf: - type: string maxLength: 400 minLength: 0 - type: 'null' title: Business Website description: Public website of the business. examples: - https://catnipcoffee.com business_description: anyOf: - type: string maxLength: 400 minLength: 0 - type: 'null' title: Business Description description: Short description of what the business does. examples: - Specialty coffee roaster and cafe industry: anyOf: - $ref: '#/components/schemas/Industry' - type: 'null' description: The industry the business operates in. account_purpose: anyOf: - $ref: '#/components/schemas/AccountPurpose' - type: 'null' description: Why the business needs the account. account_purpose_description: anyOf: - type: string maxLength: 400 minLength: 0 - type: 'null' title: Account Purpose Description description: Free-text detail for the account purpose, when relevant. provides_blockchain_or_digital_currency_services: anyOf: - type: boolean - type: 'null' title: Provides Blockchain Or Digital Currency Services description: >- Whether the business provides blockchain or digital currency services. transacts_in_digital_currency: anyOf: - type: boolean - type: 'null' title: Transacts In Digital Currency description: Whether the business transacts in digital currency. develops_governs_supports_blockchain_protocol: anyOf: - type: boolean - type: 'null' title: Develops Governs Supports Blockchain Protocol description: >- Whether the business develops, governs, or supports a blockchain protocol. business_name: anyOf: - type: string maxLength: 400 minLength: 1 - type: 'null' title: Business Name description: Legal business name. examples: - Catnip Coffee Co business_date_of_incorporation: anyOf: - $ref: '#/components/schemas/DateString' - type: 'null' description: Date the business was incorporated. incorporation_state: anyOf: - $ref: '#/components/schemas/StateCode' - type: 'null' description: State or jurisdiction of incorporation. examples: - DE legal_structure: anyOf: - $ref: '#/components/schemas/LegalStructure' - type: 'null' description: Legal structure of the business (e.g. `llc`, `corp`). business_address: anyOf: - $ref: '#/components/schemas/OnboardingAddress' - type: 'null' description: Registered legal business address. physical_address: anyOf: - $ref: '#/components/schemas/OnboardingAddress' - type: 'null' description: >- Primary operating address, sent together with `business_address`. Provide it only when it differs from the legal address; omitting it keeps a physical address already on file, or uses the legal address when none is set yet. reference_id: anyOf: - type: string maxLength: 255 minLength: 1 - type: 'null' title: Reference Id description: >- Your own identifier for this entity. Pass the same value to retry safely: a create reusing a `reference_id` you already used returns the original entity instead of creating a duplicate. examples: - order-2026-04-001 type: object title: CreateBusinessEntityRequest CreateBusinessEntityResponse: properties: id: type: string format: uuid title: Id description: >- Public ID of the new business entity. Use it as the `entity_id` path parameter on the onboarding endpoints, and in the `x-entity-id` header for entity-scoped requests once the entity is onboarded. business_name: anyOf: - type: string - type: 'null' title: Business Name description: Legal business name. created_at: $ref: '#/components/schemas/Timestamp' description: ISO 8601 timestamp of when the entity was created. type: object required: - id - business_name - created_at title: CreateBusinessEntityResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Industry: type: string enum: - accounting_bookkeeping - accounting_bookkeeping_tax_preparation - advertising - art - art_theater - art_painting - art_sculpting - beauty_cosmetic_services - biotech - business_management - cafeterias_grill_buffets_buffets - caterers - cleaning_services - construction - consulting - consulting_strategy - consulting_business - consulting_financial - crypto - crypto_exchange - crypto_investments - crypto_daos - crypto_nfts - crypto_mining - saas - design - design_web - design_digital - design_interior - design_fashion - drinking_places_alcoholic_beverages - ecommerce - ecommerce_amazon - ecommerce_ebay - ecommerce_shopify - education - education_university - education_financial - energy - energy_solar - energy_wind - energy_refining - energy_fuel - entertainment - entertainment_television - entertainment_film - entertainment_music - entertainment_print - financial_services - financial_services_money_services_business - financial_services_payment_processor - financial_services_fintech - financial_services_consumer_commercial_lending - fitness - food - food_restaurant_food_truck - food_manufacturing - food_service_contractors - full_service_restaurants - hardware - health_services - health_services_clinic - health_services_telehealth - health_services_holistic_services - health_services_healthcare_tech - holding - insurance - investment - investment_venture_capital - legal - legal_attorney - legal_paralegal - limited_service_restaurants - marketing - marketplace - merchant_banking - merges_and_acquisitions - mining - mobile_food_services - nonprofit - other - private_equity - professional_services - professional_services_architect - professional_services_attorney - professional_services_doctor - professional_services_engineer - professional_services_paralegal - real_estate - real_estate_short_term_rental - real_estate_development - real_estate_investing - real_estate_property_management - recruiting - research - research_medical - research_scientific - research_market - retail_wholesale - security - security_private - security_infosec - shipping_warehousing - sports_team - support_services - snack_and_nonalcoholic_beverage_bars - software - software_b2b - software_developer_tools - software_enterprise_software - technology - technology_agriculture - technology_artificial_intelligence - technology_augmented_reality - technology_community - technology_consumer - technology_drones - technology_government - technology_it_telecom - technology_robotics - technology_virtual_reality - transportation - transportation_limo_car_service - transportation_ride_share - travel - travel_agency - travel_hotel_reservations - waste_management - cannabis title: Industry AccountPurpose: type: string enum: - additional_yield - business_operations - other title: AccountPurpose DateString: type: string format: date title: DateString description: >- ISO 8601 full-date in the format `YYYY-MM-DD` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)). StateCode: type: string enum: - AL - AK - AZ - AR - CA - CO - CT - DC - DE - FL - GA - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - OH - OK - OR - PA - RI - SC - SD - TN - TX - UT - VT - VA - WA - WV - WI - WY - PR title: StateCode x-enum-varnames: - AL - AK - AZ - AR - CA - CO - CT - DC - DE - FL - GA - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - OH - OK - OR - PA - RI - SC - SD - TN - TX - UT - VT - VA - WA - WV - WI - WY - PR LegalStructure: type: string enum: - ccorp - corp - estate - foreign_entity - llc - llp - lp - nonprofit - partnership - scheme - scorp - soleprop - trust title: LegalStructure OnboardingAddress: properties: address: type: string maxLength: 900 minLength: 1 title: Address description: Street address line 1. examples: - 9 Whisker Way address_2: anyOf: - type: string maxLength: 900 - type: 'null' title: Address 2 description: Street address line 2. examples: - Suite 9 city: type: string maxLength: 300 minLength: 1 title: City description: City name. examples: - San Francisco state: anyOf: - type: string maxLength: 300 - type: 'null' title: State description: State or province code. examples: - CA zip: type: string maxLength: 100 minLength: 1 title: Zip description: Postal or ZIP code. examples: - '94105' country: $ref: '#/components/schemas/CountryCodeAlpha2' description: ISO 3166-1 alpha-2 country code. type: object required: - address - city - zip - country title: OnboardingAddress Timestamp: type: string format: date-time title: Timestamp description: >- ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)). ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError CountryCodeAlpha2: type: string enum: - AW - AF - AO - AI - AX - AL - AD - AE - AR - AM - AS - AQ - TF - AG - AU - AT - AZ - BI - BE - BJ - BQ - BF - BD - BG - BH - BS - BA - BL - BY - BZ - BM - BO - BR - BB - BN - BT - BV - BW - CF - CA - CC - CH - CL - CN - CI - CM - CD - CG - CK - CO - KM - CV - CR - CU - CW - CX - KY - CY - CZ - DE - DJ - DM - DK - DO - DZ - EC - EG - ER - EH - ES - EE - ET - FI - FJ - FK - FR - FO - FM - GA - GB - GE - GG - GH - GI - GN - GP - GM - GW - GQ - GR - GD - GL - GT - GF - GU - GY - HK - HM - HN - HR - HT - HU - ID - IM - IN - IO - IE - IR - IQ - IS - IL - IT - JM - JE - JO - JP - KZ - KE - KG - KH - KI - KN - KR - KW - LA - LB - LR - LY - LC - LI - LK - LS - LT - LU - LV - MO - MF - MA - MC - MD - MG - MV - MX - MH - MK - ML - MT - MM - ME - MN - MP - MZ - MR - MS - MQ - MU - MW - MY - YT - NA - NC - NE - NF - NG - NI - NU - NL - 'NO' - NP - NR - NZ - OM - PK - PA - PN - PE - PH - PW - PG - PL - PR - KP - PT - PY - PS - PF - QA - RE - RO - RU - RW - SA - SD - SN - SG - GS - SH - SJ - SB - SL - SV - SM - SO - PM - RS - SS - ST - SR - SK - SI - SE - SZ - SX - SC - SY - TC - TD - TG - TH - TJ - TK - TM - TL - TO - TT - TN - TR - TV - TW - TZ - UG - UA - UM - UY - US - UZ - VA - VC - VE - VG - VI - VN - VU - WF - WS - XK - YE - ZA - ZM - ZW title: CountryCodeAlpha2 x-enum-varnames: - AW - AF - AO - AI - AX - AL - AD - AE - AR - AM - AS - AQ - TF - AG - AU - AT - AZ - BI - BE - BJ - BQ - BF - BD - BG - BH - BS - BA - BL - BY - BZ - BM - BO - BR - BB - BN - BT - BV - BW - CF - CA - CC - CH - CL - CN - CI - CM - CD - CG - CK - CO - KM - CV - CR - CU - CW - CX - KY - CY - CZ - DE - DJ - DM - DK - DO - DZ - EC - EG - ER - EH - ES - EE - ET - FI - FJ - FK - FR - FO - FM - GA - GB - GE - GG - GH - GI - GN - GP - GM - GW - GQ - GR - GD - GL - GT - GF - GU - GY - HK - HM - HN - HR - HT - HU - ID - IM - IN - IO - IE - IR - IQ - IS - IL - IT - JM - JE - JO - JP - KZ - KE - KG - KH - KI - KN - KR - KW - LA - LB - LR - LY - LC - LI - LK - LS - LT - LU - LV - MO - MF - MA - MC - MD - MG - MV - MX - MH - MK - ML - MT - MM - ME - MN - MP - MZ - MR - MS - MQ - MU - MW - MY - YT - NA - NC - NE - NF - NG - NI - NU - NL - 'NO' - NP - NR - NZ - OM - PK - PA - PN - PE - PH - PW - PG - PL - PR - KP - PT - PY - PS - PF - QA - RE - RO - RU - RW - SA - SD - SN - SG - GS - SH - SJ - SB - SL - SV - SM - SO - PM - RS - SS - ST - SR - SK - SI - SE - SZ - SX - SC - SY - TC - TD - TG - TH - TJ - TK - TM - TL - TO - TT - TN - TR - TV - TW - TZ - UG - UA - UM - UY - US - UZ - VA - VC - VE - VG - VI - VN - VU - WF - WS - XK - YE - ZA - ZM - ZW securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Your Meow API key, sent in the `x-api-key` header for authentication. x-scopes: - accounts:read - accounts:write - accounts:payment-networks - accounts:transactions - accounts:balances - accounts:statements - accounts:tax-documents - entity:create - transfers:crypto:write - transfers:usdc:write - transfers:ach:write - transfers:wire:write - transfers:book:write - contacts:read - contacts:write - billing:products:read - billing:products:write - billing:customers:read - billing:customers:write - billing:invoices:read - billing:invoices:write - billing:accounts:read - billpay:read - billpay:write - onboarding:read - onboarding:write - cards:read - cards:write - webhooks:read - webhooks:write - partner:onboarding:read - partner:onboarding:write - partner:webhooks:read - partner:webhooks:write - simulations:write - banking:limits:read - banking:limits:write ````