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

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

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

## Request

- Base URL: `https://public-api.sandbox.bunq.com/v1`
- URL: `https://public-api.sandbox.bunq.com/v1/user/{userID}/monetary-account/{monetary-accountID}/bunqme-tab/{itemId}`
- Auth: none declared. Required headers: `User-Agent`, `X-Bunq-Client-Authentication`

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
- `itemId` 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.

- BunqMeTabUpdate
  - `Id` BunqId
    - `id` integer: An integer ID of an object. Unique per object type.

## Other responses

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

## Changes

- **2024-02-21** `f9335de3c80b`: 1 info
  - added the new optional request property `event_id`
- **2024-01-08** `8dfb44c77ea0`: 1 warning
  - removed the request property `event_id`

[Operation history](https://skmtc.dev/bunq/apis/bunq-api/changes/user/:userID/monetary-account/:monetary-accountID/bunqme-tab/:itemId/put.md)

---

[API](https://skmtc.dev/bunq/apis/bunq-api.md) - [All operations](https://skmtc.dev/bunq/apis/bunq-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunq/apis/bunq-api/revisions/369477c7bd26?raw)