---
title: "Update a Client"
method: PUT
path: "/v2.01/{ClientId}/clients"
tags: ["Client"]
---

# Update a Client

`PUT /v2.01/{ClientId}/clients`

Modify certain information registered with Mangopay for your platform, notably:
- `PrimaryThemeColour` and `PrimaryButtonColour`, which you can use to customize the appearance of Mangopay's hosted SCA - [read more](/guides/sca/factors#customization) **→**

## Path parameters

- `ClientId` string, required

## Headers

- `Authorization` string, required

## Request body

- UpdateAClientRequest
  - `TechEmails` string[] — Format: Emails must be ≤ 40 characters List of email addresses to contact the platform for technical matters. Important: If the email length exceeds 40 characters, it will be be impossible to process some payments.
  - `AdminEmails` string[] — List of email addresses to contact the platform for administrative or commercial matters.
  - `BillingEmails` string[] — List of email addresses to contact the platform for billing matters.
  - `FraudEmails` string[] — List of email addresses to contact the platform for fraud and compliance matters.
  - `HeadquartersAddress` AddressPlatformHeadquarters — The address of the platform operator's headquarters. This parameter must be provided for the platform's payouts to be processed.
    - `AddressLine1` string, required — The first line of the address.
    - `AddressLine2` string — The second line of the address.
    - `City` string, required — The city of the address.
    - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
    - `PostalCode` string, required — Required if `HeadquarterAddress` is sent. The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
    - `Country` string, required — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
  - `HeadquartersPhoneNumber` string — Max. length: 15 characters; international telephone numbering plan E.164 (+ followed by the country code, then the number) The phone number of the platform operator's headquarters.
  - `TaxNumber` string — The tax (or VAT) number for the company operating the platform.
  - `PlatformURL` string — The URL of the platform's website.
  - `PlatformDescription` string — Max. length: 2,000 characters The description of what the platform does.
  - `PrimaryThemeColour` string — Hex color code The color used in accent highlights and icon elements on Mangopay-hosted webpages, such as in [SCA customization](/guides/sca/factors#customization).
  - `PrimaryButtonColour` string — Hex color code The color used for call-to-action (CTA) buttons on Mangopay-hosted webpages, such as in [SCA customization](/guides/sca/factors#customization).

## Response `200`

Success

- UpdateAClientResponse
  - `PlatformType` string — Type of the platform. This field has been replaced by the `PlatformCategorization` object.
  - `ClientId` string — The unique identifier associated with the API key, giving access to either the Sandbox or Production environment.
  - `Name` string — The trading name of the company operating the platform.
  - `RegisteredName` string — The registered legal name of the company operating the platform.
  - `TechEmails` string[] — Format: Emails must be ≤ 40 characters List of email addresses to contact the platform for technical matters. Important: If the email length exceeds 40 characters, it will be be impossible to process some payments.
  - `AdminEmails` string[] — List of email addresses to contact the platform for administrative or commercial matters.
  - `BillingEmails` string[] — List of email addresses to contact the platform for billing matters.
  - `FraudEmails` string[] — List of email addresses to contact the platform for fraud and compliance matters.
  - `HeadquartersAddress` Address — The postal address.
    - `AddressLine1` string — The first line of the address.
    - `AddressLine2` string — The second line of the address.
    - `City` string — The city of the address.
    - `Region` string — Required if `Country` is US, CA, or MX. The region of the address.
    - `PostalCode` string — The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.
    - `Country` string — Format: Two-letter country code ([ISO 3166-1 alpha-2 format](/api-reference/overview/data-formats)) The country of the address.
  - `HeadquartersPhoneNumber` string — Max. length: 15 characters; international telephone numbering plan E.164 (+ followed by the country code, then the number) The phone number of the platform operator's headquarters.
  - `TaxNumber` string — The tax (or VAT) number for the company operating the platform.
  - `PlatformCategorization` UpdateAClientResponsePlatformCategorization — The categorization of the platform in terms of business and sector of activity.
    - `BusinessType` string — The business type of the platform.
    - `Sector` string — The sector of activity of the platform.
  - `PlatformURL` string — The URL of the platform's website.
  - `PlatformDescription` string — Max. length: 2,000 characters The description of what the platform does.
  - `CompanyReference` string — The unique reference for the platform, which should be used when contacting Mangopay.
  - `PrimaryThemeColour` string — Hex color code The color used in accent highlights and icon elements on Mangopay-hosted webpages, such as in [SCA customization](/guides/sca/factors#customization).
  - `PrimaryButtonColour` string — Hex color code The color used for call-to-action (CTA) buttons on Mangopay-hosted webpages, such as in [SCA customization](/guides/sca/factors#customization).
  - `Logo` string — The URL of the platform's logo. Logos may be added by using the Upload a Client Logo endpoint.
  - `CompanyNumber` string — The registration number of the company operating the platform, assigned by the relevant national authority.
  - `MCC` string — 4-digit merchant category code. The MCC is used to classify a business by the types of goods or services it provides.

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)