--- title: "Create Organization" method: POST path: "/organizations" tags: ["Organizations"] --- # Create Organization `POST /organizations` ## Request - Base URL: `https://partner-api.getpliant.com/api` - URL: `https://partner-api.getpliant.com/api/organizations` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Creates a new organization for onboarding via a partner integration. ## Headers - `Idempotency-Key` string, required ## Request body - object - `name` string, required: Legal entity name. - `country` string, required: ISO 3166-1 alpha-2 country code. - `currency` string, required: ISO 4217 currency code. - `billingAddress` object, required - `streetName` string, required: Street name. - `streetNumber` string, required: Street number. - `streetAdditional` string: Additional address line (e.g. apartment, floor). - `postalCode` string, required: Postal code. Validated against country-specific format. - `city` string, required: City. - `subdivisionCode` string: ISO 3166-2 subdivision code without the country prefix (e.g. `NY` for New York, US). Optional — recommended for US addresses. - `country` string, required: ISO 3166-1 alpha-2 country code. Must match the top-level `country` field. - `legalForm` string, required: Legal form of the entity. Use a value for the organization's `country` from [Legal forms by country](/docs/legal-forms-by-country). Preserve the exact spelling, capitalization, spaces, and punctuation. - `vatId` string: VAT identification number. - `tradeRegisterNumber` string, required: Trade register number of the legal entity. - `nationalRegisterCourt` string: National register court. Required for DE only. - `foundationDate` string, date, required: Foundation date of the legal entity in ISO 8601 format (YYYY-MM-DD). Must be in the past. - `partnerOrganizationId` string, required: Your permanent reference ID for this organization (e.g. your internal business customer ID). Stored verbatim, echoed back on all responses, and enforced as unique per partner — prevents logical duplicates across separate API calls. Distinct from the Idempotency-Key header, which handles network-level retry safety. - `metadata` object: Arbitrary key-value pairs for storing additional information on this Pliant object. For your own use and reference. - `leadData` object: Additional lead information used for sales qualification and CRM enrichment. - `accountType` 'CREDIT' | 'PREFUNDED', required: If known, which card product is requested by customer. Either with credit line (=credit) or without credit line (=prefund). - `industry` 'ACCOUNTING' | 'AIRLINES_AVIATION' | 'ALTERNATIVE_DISPUTE_RESOLUTION' | 'ALTERNATIVE_MEDICINE' | 'ANIMATION' | 'APPAREL_FASHION' | 'ARCHITECTURE_PLANNING' | 'ARTS_AND_CRAFTS' | 'AUTOMOTIVE' | 'AVIATION_AEROSPACE' | 'BANKING' | 'BIOTECHNOLOGY' | 'BROADCAST_MEDIA' | 'BUILDING_MATERIALS' | 'BUSINESS_SERVICES' | 'BUSINESS_SUPPLIES_AND_EQUIPMENT' | 'CAPITAL_MARKETS' | 'CHEMICALS' | 'CIVIC_SOCIAL_ORGANIZATION' | 'CIVIL_ENGINEERING' | 'COMMERCIAL_REAL_ESTATE' | 'COMPUTER_GAMES' | 'COMPUTER_HARDWARE' | 'COMPUTER_NETWORK_SECURITY' | 'COMPUTER_NETWORKING' | 'COMPUTER_SOFTWARE' | 'CONSTRUCTION' | 'CONSUMER_ELECTRONICS' | 'CONSUMER_GOODS' | 'CONSUMER_SERVICES' | 'CONVENIENCE_STORES_GAS_STATIONS_LIQUOR_STORES' | 'COSMETICS' | 'DAIRY' | 'DEFENSE_SPACE' | 'DESIGN' | 'E_COMMERCE' | 'E_LEARNING' | 'EDUCATION_MANAGEMENT' | 'ELECTRICAL_ELECTRONIC_MANUFACTURING' | 'ENTERTAINMENT' | 'ENVIRONMENTAL_SERVICES' | 'EVENTS_SERVICES' | 'EXECUTIVE_OFFICE' | 'FACILITIES_SERVICES' | 'FARMING' | 'FINANCIAL_SERVICES' | 'FINE_ART' | 'FISHERY' | 'FOOD_BEVERAGES' | 'FOOD_PRODUCTION' | 'FUND_RAISING' | 'FURNITURE' | 'GAMBLING_CASINOS' | 'GLASS_CERAMICS_CONCRETE' | 'GOVERNMENT_ADMINISTRATION' | 'GOVERNMENT_RELATIONS' | 'GRAPHIC_DESIGN' | 'HEALTH_WELLNESS_AND_FITNESS' | 'HIGHER_EDUCATION' | 'HOSPITAL_HEALTH_CARE' | 'HOSPITALITY' | 'HUMAN_RESOURCES' | 'IMPORT_AND_EXPORT' | 'INDIVIDUAL_FAMILY_SERVICES' | 'INDUSTRIAL_AUTOMATION' | 'INFORMATION_SERVICES' | 'INFORMATION_TECHNOLOGY_AND_SERVICES' | 'INSURANCE' | 'INTERNATIONAL_AFFAIRS' | 'INTERNATIONAL_TRADE_AND_DEVELOPMENT' | 'INTERNET' | 'INVESTMENT_BANKING' | 'INVESTMENT_MANAGEMENT' | 'IT_SERVICE' | 'JUDICIARY' | 'LAW_ENFORCEMENT' | 'LAW_PRACTICE' | 'LEGAL_SERVICES' | 'LEGISLATIVE_OFFICE' | 'LEISURE_TRAVEL_TOURISM' | 'LIBRARIES' | 'LOGISTICS_AND_SUPPLY_CHAIN' | 'LUXURY_GOODS_JEWELRY' | 'MACHINERY' | 'MANAGEMENT_CONSULTING' | 'MARITIME' | 'MARKET_RESEARCH' | 'MARKETING_AND_ADVERTISING' | 'MECHANICAL_OR_INDUSTRIAL_ENGINEERING' | 'MEDIA_PRODUCTION' | 'MEDICAL_DEVICES' | 'MEDICAL_PRACTICE' | 'MENTAL_HEALTH_CARE' | 'MILITARY' | 'MINING_METALS' | 'MOTION_PICTURES_AND_FILM' | 'MUSEUMS_AND_INSTITUTIONS' | 'MUSIC' | 'NANOTECHNOLOGY' | 'NEWSPAPERS' | 'NON_PROFIT_ORGANIZATION_MANAGEMENT' | 'OIL_ENERGY' | 'ONLINE_MEDIA' | 'OUTSOURCING_OFFSHORING' | 'PACKAGE_FREIGHT_DELIVERY' | 'PACKAGING_AND_CONTAINERS' | 'PAPER_FOREST_PRODUCTS' | 'PERFORMING_ARTS' | 'PHARMACEUTICALS' | 'PHILANTHROPY' | 'PHOTOGRAPHY' | 'PLASTICS' | 'POLITICAL_ORGANIZATION' | 'PRIMARY_SECONDARY_EDUCATION' | 'PRINTING' | 'PROFESSIONAL_TRAINING_COACHING' | 'PROGRAM_DEVELOPMENT' | 'PUBLIC_POLICY' | 'PUBLIC_RELATIONS_AND_COMMUNICATIONS' | 'PUBLIC_SAFETY' | 'PUBLISHING' | 'RAILROAD_MANUFACTURE' | 'RANCHING' | 'REAL_ESTATE' | 'RECREATIONAL_FACILITIES_AND_SERVICES' | 'RELIGIOUS_INSTITUTIONS' | 'RENEWABLES_ENVIRONMENT' | 'RESEARCH' | 'RESTAURANTS' | 'RETAIL' | 'SECURITY_AND_INVESTIGATIONS' | 'SEMICONDUCTORS' | 'SHIPBUILDING' | 'SPORTING_GOODS' | 'SPORTS' | 'STAFFING_AND_RECRUITING' | 'SUPERMARKETS' | 'TELECOMMUNICATIONS' | 'TEXTILES' | 'THINK_TANKS' | 'TOBACCO' | 'TRANSLATION_AND_LOCALIZATION' | 'TRANSPORTATION' | 'TRANSPORTATION_TRUCKING_RAILROAD' | 'UTILITIES' | 'VENTURE_CAPITAL_PRIVATE_EQUITY' | 'VETERINARY' | 'WAREHOUSING' | 'WHOLESALE' | 'WINE_AND_SPIRITS' | 'WIRELESS' | 'WRITING_AND_EDITING': Industry of the legal entity. - `yearlyRevenue` object: Estimated yearly revenue. - `value` integer, required: Amount in minor units (cents). - `currency` string, required: ISO 4217 currency code. - `numberOfEmployees` integer: Number of employees of the referred legal entity. - `plannedNumberOfCards` integer: Estimated number of virtual and/or physical credit cards the referred legal entity will issue. - `paymentFrequency` 'MONTHLY' | 'BI-WEEKLY' | 'WEEKLY' | 'DAILY' | 'PREFUNDED': Desired payment frequency. Use `PREFUNDED` for prefunded account types. - `expectedMonthlyTransactionVolume` object - `value` integer, required: Amount in minor units (cents). - `currency` string, required: ISO 4217 currency code. - `customerAcquisitionChannel` 'OUTBOUND' | 'INBOUND' | 'REFERRAL' | 'PARTNER' | 'CAMPAIGN', required: Channel through which the customer was acquired. - `customerRelationshipLength` integer, required: Length of the existing relationship with the customer, in months. - `contacts` object[], required: List of contact persons for the lead (relevant for HubSpot). Maximum 5 contacts. - `salutation` 'MRS' | 'MR': Salutation of the contact person. - `firstName` string, required: First name of the contact person. - `lastName` string, required: Last name of the contact person. - `email` string, email, required: Email address of the contact person. - `phone` string: Phone number of the contact person. - `contactRole` 'CONTACT' | 'LEGAL_REP': Role of the person within the legal entity. - `LEGAL_REP`: Legal representative; the only role that can complete onboarding (e.g. sign terms and conditions). - `CONTACT`: Default for all other relevant contacts who are not legal representatives. - `comment` string: Any additional context or notes to consider for this lead. - `partnerContact` object - `name` string, required: Full name of the partner contact responsible for the lead. - `email` string, email, required: Email address of the partner contact. ## Response `201` Created - object - `id` string, uuid: Pliant-assigned organization ID. - `name` string - `country` string - `currency` string - `billingAddress` object - `streetName` string - `streetNumber` string - `streetAdditional` string - `postalCode` string - `city` string - `subdivisionCode` string - `country` string - `legalForm` string - `vatId` string - `tradeRegisterNumber` string - `nationalRegisterCourt` string - `foundationDate` string, date - `accountGroup` string - `accountType` 'CREDIT' | 'PREFUNDED' - `partnerOrganizationId` string - `metadata` object - `status` Schema (unresolved $ref) - `createdAt` string, date-time: Timestamp when the organization was created (ISO 8601). ## Other responses - `400` (unresolved $ref) - `401` (unresolved $ref) - `403` (unresolved $ref) - `422`: Unprocessable Entity. The organization cannot be onboarded. This may be due to a duplicate registration detected internally. The specific reason is intentionally not disclosed. - `429` (unresolved $ref) - `500` (unresolved $ref) ## Changes - **2026-11-03** `a4fbf7d068b4`: 1 info - endpoint added [Operation history](https://skmtc.dev/getpliant/apis/pliant-customer-api/changes/organizations/post.md) --- [API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) - [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getpliant/apis/pliant-customer-api/revisions/a4fbf7d068b4?raw)