---
title: "Create a Firm"
method: POST
path: "/api/v2_1/firms"
tags: ["Partner-Merchant-Registration"]
---

# Create a Firm

`POST /api/v2_1/firms`

## Request

- Base URL: `https://secure.payu.com`
- URL: `https://secure.payu.com/api/v2_1/firms`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api/docs/api/v2_1/firms/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a Firm entity for your partner.

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- object
  - `name` string, required: Full legal name.
  - `type` string, required: Dictionary value - legal entity type. Dictionary is available [here](/europe/docs/collaboration/referral-program/#firm-types). For a firm which <code>address.country</code> code is not equal to <code>businessArea.origin</code> please use <b>FZ</b> type. <b>Providing accurate type speeds up merchant verification.</b>
  - `taxId` string, required: Tax identification.
  - `taxIdType` 'NIP' | 'VAT_EU' | 'TAX_ID', required: Type of tax identification.
  - `cin` string, required: Business identification. IČ (CZ) or REGON (PL).
  - `partnerId` string, required: Your partner id.
  - `contactLanguage` 'EN' | 'PL' | 'CS' | 'RO': Preferred language for communication.
  - `businessArea` object, required: Business area of the registered firm.
    - `origin` string, required: Denotes firm origin and applies validation and requirements for this origin. Currently only two values are available: <b>CZ</b> and <b>PL</b>. <b>It is still possible to register a firm which is incorporated outside of Czechia or Poland</b>.
  - `users` object[], required: Array of PayU panel users. At least 1 must be provided.
    - `name` string, required: User's first name.
    - `surname` string, required: User's last name.
    - `email` string, required: User's email.
    - `phone` string: User's phone number.
    - `role` 'MANAGER' | 'USER', required: User's role.
  - `representatives` object[], required: Array of firm legal representatives. At least 1 must be provided.
    - `name` string, required: Representative's first name.
    - `surname` string, required: Representative's last name.
    - `nin` string: Representative's national identity number (PESEL). <b>Required only for Polish citizens</b>
    - `countryCode` string, required: Representative's citizenship. Must be a valid ISO 3166-1 two-letter code.
    - `birthDate` string, RRRR-MM-DD: Representative's date of birth. <b>Required only for non-Polish citizens</b>
    - `birthCountryCode` string, required: Country code of representative's birth country. Must be a valid ISO 3166-1 two-letter code.
  - `contactData` object, required: Object containing firm's contact details.
    - `phone` string, required: Firm's contact phone number.
    - `email` string, required: Firm's contact email address.
  - `technicalContactData` object: Object containing firm's technical contact details (e.g. to the developer responsible for integration with PayU).
  - `address` object, required: Firm's registration address.
    - `street` string, required: Firm's registration address street.
    - `houseNo` string, required: Firm's registration address house number.
    - `apartmentNo` string, required: Firm's registration address apartment number.
    - `postalCode` string, required: Firm's registration address postal code.
    - `city` string, required: Firm's registration address city.
    - `countryCode` string, required: Firm's registration address country code. Must be a valid ISO 3166-1 two-letter code.
  - `correspondenceAddress` object: Firm's correspondence address (<b>if other than registration address</b>). This object the same fields as address.
    - `street` string, required: Firm's registration address street.
    - `houseNo` string, required: Firm's registration address house number.
    - `apartmentNo` string, required: Firm's registration address apartment number.
    - `postalCode` string, required: Firm's registration address postal code.
    - `city` string, required: Firm's registration address city.
    - `countryCode` string, required: Firm's registration address country code. Must be a valid ISO 3166-1 two-letter code.

## Response `200`

- object
  - `firmId` string: Identifier that needs to be stored in your system and is used to create further entities for that firm.

## Other responses

- `401`

---

[API](https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api.md) - [All operations](https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payu-com/apis/payu-gpo-europe-rest-api/revisions/185e74d5e007?raw)