---
title: "Upsert Tenant Business Card"
method: PUT
path: "/api/admin/tenants/{tenant_id}/peppol/business-card"
tags: ["Admin"]
---

# Upsert Tenant Business Card

`PUT /api/admin/tenants/{tenant_id}/peppol/business-card`

## Request

- Base URL: `https://api.e-invoice.be`
- URL: `https://api.e-invoice.be/api/admin/tenants/{tenant_id}/peppol/business-card`
- Auth: HTTP bearer

Create or update a business card for a Peppol participant.
Supports partial updates by merging with existing business card data.
Currently only allowed to change the name.

## Path parameters

- `tenant_id` string, required

## Request body

- BusinessCardRequest
  - `peppol_id` string, required: Peppol ID (must be 0208:<digits> for Belgium)
  - `name` string, nullable: Business entity name

## Response `200`

Successful Response

- BusinessCardUpsertResponse: Response schema for business card upsert.
  - `success` boolean, required

## Other responses

- `400`: Bad Request: Invalid input parameters or missing required fields for new business card
- `401`: Unauthorized: Invalid or missing admin key
- `403`: Forbidden: Peppol operations not available for organizations in test mode
- `404`: Not Found: Tenant not found
- `422`: Validation Error
- `500`: Internal Server Error: Unexpected server error
- `502`: Bad Gateway: SMP service failed

## Changes

- **2025-10-31** `97871d8011b0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/e-invoice-be/apis/e-invoice-be-peppol-access-point-api/changes/api/admin/tenants/:tenant_id/peppol/business-card/put.md)

---

[API](https://skmtc.dev/e-invoice-be/apis/e-invoice-be-peppol-access-point-api.md) - [All operations](https://skmtc.dev/e-invoice-be/apis/e-invoice-be-peppol-access-point-api/llms.txt) - [OpenAPI document](https://skmtc.dev/e-invoice-be/apis/e-invoice-be-peppol-access-point-api/revisions/0ee5e3d3992a?raw)