--- title: "Create Business Entity" method: POST path: "/entities" tags: ["Entities"] --- # Create Business Entity `POST /entities` ## Request - Base URL: `https://api.meow.com/v1` - URL: `https://api.meow.com/v1/entities` - Auth: API key in header `x-api-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Request body - CreateBusinessEntityRequest - `business_phone` string, nullable: Business phone number. - `business_taxid` string, nullable: Business tax ID: the EIN for US businesses, or the local registration/tax number elsewhere (e.g. UEN in Singapore, UTR in the UK). - `business_website` string, nullable: Public website of the business. - `business_description` string, nullable: Short description of what the business does. - `business_asset_source_description` string, nullable: Description of the source of the business's assets. Required before submitting an application that requests `stablecoins`. - `industry` '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' - `account_purpose` 'additional_yield' | 'business_operations' | 'other' - `account_purpose_description` string, nullable: Free-text detail for the account purpose, when relevant. - `provides_blockchain_or_digital_currency_services` boolean, nullable: Whether the business provides blockchain or digital currency services. - `transacts_in_digital_currency` boolean, nullable: Whether the business transacts in digital currency. - `develops_governs_supports_blockchain_protocol` boolean, nullable: Whether the business develops, governs, or supports a blockchain protocol. - `business_name` string, nullable: Legal business name. - `business_date_of_incorporation` string, date: 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)). - `incorporation_state` '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' - `legal_structure` 'ccorp' | 'corp' | 'estate' | 'foreign_entity' | 'llc' | 'llp' | 'lp' | 'nonprofit' | 'partnership' | 'scheme' | 'scorp' | 'soleprop' | 'trust' - `business_address` OnboardingAddress - `address` string, required: Street address line 1. - `address_2` string, nullable: Street address line 2. - `city` string, required: City name. - `state` string, nullable: State or province code. - `zip` string, required: Postal or ZIP code. - `country` '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', required - `physical_address` OnboardingAddress - `address` string, required: Street address line 1. - `address_2` string, nullable: Street address line 2. - `city` string, required: City name. - `state` string, nullable: State or province code. - `zip` string, required: Postal or ZIP code. - `country` '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', required - `reference_id` string, nullable: 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. ## Response `201` Successful Response - CreateBusinessEntityResponse - `id` string, uuid, required: 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` string, nullable, required: Legal business name. - `created_at` string, date-time, required: 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)). ## Other responses - `400`: The request could not be processed. - `401`: Authentication failed. - `403`: The API key is not authorized for this operation. - `429`: Too many requests. --- [API](https://skmtc.dev/meow/apis/meow-api.md) - [All operations](https://skmtc.dev/meow/apis/meow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meow/apis/meow-api/revisions/ea2d7e25b63b?raw)