---
title: "Create a URL for the Partner's Firm"
method: POST
path: "/api/v2_1/firms/{firmId}/urls"
tags: ["Partner-Merchant-Registration"]
---

# Create a URL for the Partner's Firm

`POST /api/v2_1/firms/{firmId}/urls`

## Request

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

Create a URL for the specified `firmId`.

## Headers

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

## Request body

- object
  - `value` string, required: URL address.
  - `mcc` string: Merchant Category Code (value is validated). Data type
  - `services` object[], required: Array of service types.
    - `type` 'TRANSFERS' | 'CARD' | 'INSTALLMENTS' | 'DELAYED_PAYMENTS', required: Dictionary value:<ul> <li><b>TRANSFERS</b> - online transfers ("pay-by-links" and standard bank transfers, incl. Blik),</li> <li><b>CARD</b> - cards (Visa, Mastercard) and digital wallets (Apple Pay, Google Pay),</li> <li><b>INSTALLMENTS</b> - online installments,</li> <li><b>DELAYED_PAYMENTS</b> - "pay later" methods.</li></ul>

## Response `200`

- object
  - `urlId` string: urlId that needs to be stored in your system can be used to create shop.

## 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)