MOmonei
Customers

Update Customer

Changed on

Updates a customer. Only the fields you send are changed.

Changing the default payment method:

Set defaultTokenId to the ID of a payment method this customer already owns. It must be one that can be reused for future payments — a payment method saved for a single use is rejected.

MONEI only ever fills a default that is empty, so a value you set here is kept. Deleting that payment method clears the field, and the next reusable one the customer saves becomes the new default.

What updating does not do:

Updating a customer never changes a payment or a subscription that already exists. Their copies of the customer's details were taken when they were created, so a corrected email here does not rewrite last month's receipt.

put/customers/{id}

Request

Request body

emailstring

The customer's email address.

namestring

The customer's full name or business name.

phonestring

The customer's phone number in E.164 format.

metadataMetadata

A set of key-value pairs that you can attach to a resource. This can be useful for storing additional information about the resource in a structured format.

defaultTokenIdstring

The payment method charged when a payment sets useDefaultPaymentMethod.

MONEI fills this only while it is empty: the first reusable payment method the customer saves becomes the default, and a value you set here is kept. Deleting that payment method clears the field, so the next reusable one the customer saves becomes the new default. It must be the ID of a payment method this customer already owns, and one that can be reused for future payments.

Example request

{
  "email": "john.doe@example.com",
  "name": "John Doe",
  "phone": "+34666666666",
  "billingDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "address": {
      "country": "ES",
      "city": "Málaga",
      "line1": "Fake Street 123",
      "zip": "1234",
      "state": "Málaga"
    }
  },
  "shippingDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "address": {
      "country": "ES",
      "city": "Málaga",
      "line1": "Fake Street 123",
      "zip": "1234",
      "state": "Málaga"
    }
  },
  "metadata": {
    "systemId": "12345"
  },
  "defaultTokenId": "7cc38b08ff471ccd313ad62b23b9f362b107560b"
}

Response

A customer object

idstring uuid required

Unique identifier for the customer.

emailstring

The customer's email address.

namestring

The customer's full name or business name.

phonestring

The customer's phone number in E.164 format.

metadataMetadata

A set of key-value pairs that you can attach to a resource. This can be useful for storing additional information about the resource in a structured format.

defaultTokenIdstring

The payment method charged when a payment sets useDefaultPaymentMethod.

MONEI fills this only while it is empty: the first reusable payment method the customer saves becomes the default, and a value you set here is kept. Deleting that payment method clears the field, so the next reusable one the customer saves becomes the new default. It must be the ID of a payment method this customer already owns, and one that can be reused for future payments.

createdAtstring date-time

Time at which the resource was created.

updatedAtstring date-time

Time at which the resource was last updated.

Example response

{
  "id": "a4e1d1dd-e0c2-4f7a-a2b1-2b0f1f9b6b1e",
  "email": "john.doe@example.com",
  "name": "John Doe",
  "phone": "+34666666666",
  "billingDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "address": {
      "country": "ES",
      "city": "Málaga",
      "line1": "Fake Street 123",
      "zip": "1234",
      "state": "Málaga"
    }
  },
  "shippingDetails": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "address": {
      "country": "ES",
      "city": "Málaga",
      "line1": "Fake Street 123",
      "zip": "1234",
      "state": "Málaga"
    }
  },
  "metadata": {
    "systemId": "12345"
  },
  "defaultTokenId": "7cc38b08ff471ccd313ad62b23b9f362b107560b",
  "createdAt": "2026-09-21T10:25:52.000Z",
  "updatedAt": "2026-09-21T10:25:52.000Z"
}

Changes