---
title: "POST /user/{userID}/monetary-account/{monetary-accountID}/bunqme-tab"
method: POST
path: "/user/{userID}/monetary-account/{monetary-accountID}/bunqme-tab"
tags: ["bunqme-tab"]
---

# POST /user/{userID}/monetary-account/{monetary-accountID}/bunqme-tab

`POST /user/{userID}/monetary-account/{monetary-accountID}/bunqme-tab`

bunq.me tabs allows you to create a payment request and share the link through e-mail, chat, etc. Multiple persons are able to respond to the payment request and pay through bunq, iDeal or SOFORT.

## Path parameters

- `userID` integer, required
- `monetary-accountID` integer, required

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Request body

- BunqMeTab
  - `bunqme_tab_entry` BunqMeTabEntry, required
    - `amount_inquired` Amount
      - `value` string — The amount formatted to two decimal places.
      - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
    - `description` string — The description for the bunq.me. Maximum 9000 characters.
    - `redirect_url` string — The URL which the user is sent to when a payment is completed.
    - `uuid` string — The uuid of the bunq.me.
    - `alias` LabelMonetaryAccount
      - `iban` string — The IBAN of the monetary account.
      - `display_name` string — The name to display with this monetary account.
      - `avatar` Avatar
        - `uuid` string — The public UUID of the avatar.
        - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
        - `image` Image[] — The actual image information of this avatar.
          - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
          - `content_type` string — The content-type as a MIME filetype.
          - `height` integer — The image height in pixels.
          - `width` integer — The image width in pixels.
        - `style` string — The style (if applicable) for this Avatar.
      - `label_user` LabelUser
        - `uuid` string — The public UUID of the label-user.
        - `display_name` string — The name to be displayed for this user, as it was given on the request.
        - `country` string — The country of the user. 000 stands for "unknown"
        - `avatar` Avatar
          - `uuid` string — The public UUID of the avatar.
          - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
          - `image` Image[] — The actual image information of this avatar.
            - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
            - `content_type` string — The content-type as a MIME filetype.
            - `height` integer — The image height in pixels.
            - `width` integer — The image width in pixels.
          - `style` string — The style (if applicable) for this Avatar.
        - `public_nick_name` string — The current nickname of the user.
      - `country` string — The country of the user. Formatted as a ISO 3166-1 alpha-2 country code.
      - `bunq_me` Pointer
        - `type` string — The alias type, can be: EMAIL|PHONE_NUMBER|IBAN.
        - `value` string — The alias value.
        - `name` string — The alias name.
        - `service` string — The pointer service. Only required for external counterparties.
      - `is_light` boolean — Whether or not the monetary account is light.
      - `swift_bic` string — The BIC used for a SWIFT payment.
      - `swift_account_number` string — The account number used for a SWIFT payment. May or may not be an IBAN.
      - `transferwise_account_number` string — The account number used for a Transferwise payment. May or may not be an IBAN.
      - `transferwise_bank_code` string — The bank code used for a Transferwise payment. May or may not be a BIC.
      - `merchant_category_code` string — The merchant category code.
    - `status` string — The status of the bunq.me. Can be WAITING_FOR_PAYMENT, CANCELLED or EXPIRED.
    - `merchant_available` BunqMeMerchantAvailable[] — List of available merchants.
      - `merchant_type` string — A merchant type supported by bunq.me.
      - `available` boolean — Whether or not the merchant is available for the user.
    - `invite_profile_name` string — Provided if the user has enabled their invite link.
  - `status` string — The status of the bunq.me. Ignored in POST requests but can be used for cancelling the bunq.me by setting status as CANCELLED with a PUT request.
  - `event_id` integer — The ID of the related event if the bunqMeTab made by 'split' functionality.

## Response `200`

bunq.me tabs allows you to create a payment request and share the link through e-mail, chat, etc. Multiple persons are able to respond to the payment request and pay through bunq, iDeal or SOFORT.

- BunqMeTabCreate
  - `id` integer — The id of the created bunq.me.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/revisions/369477c7bd26/schema)