Update your account settings and preferences

Modify your personal settings and preferences related to your account, including how you receive messages and other account-specific configurations.

Account & Settings Preferences

Context

Used in the dashboard

/ /account

Related endpoints

GET /api/account/preferences Get and update account settings and preferences GET /api/account/stats Get account statistics and overview POST /api/account/update Update customer details on your account

Headers

Accept Example

Content-Type Example

Body

required

application/json

peppol_opt_out boolean required · Example: false

Responses

200

data object required

data.preferences object required

data.preferences.bankid_only_login boolean required · Example: false

data.preferences.client_id integer required · Example: 30000

data.preferences.created_at string required · Example: 2026-02-10T00:00:00.000Z

data.preferences.email_notifications boolean required · Example: true

data.preferences.id integer required · Example: 19

data.preferences.language string · enum required · Example: sv

en

sv

data.preferences.peppol_opt_out boolean required · Example: false

data.preferences.peppol_opt_out_date string · nullable required · Example: 2026-02-10T00:00:00.000Z

Nullable: may be null when not applicable.

data.preferences.peppol_opt_out_reason string · nullable required · Example: customer_request

Nullable: may be null when not applicable.

data.preferences.sms_notifications boolean required · Example: false

data.preferences.timezone string required · Example: Europe/Stockholm

data.preferences.two_factor_enabled boolean required · Example: false

data.preferences.updated_at string required · Example: 2026-02-10T00:00:00.000Z

data.success boolean required · Example: true

True for successful responses.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

500

code string required · Example: INTERNAL_ERROR

Machine-readable error code.

error string required · Example: Internal Server Error

HTTP status title (e.g. 'Bad Request').

message string required · Example: An unexpected error occurred

Human-readable message.

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/account/preferences

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/account/preferences" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "peppol_opt_out": false
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "success": true,
    "preferences": {
      "id": 19,
      "client_id": 30000,
      "bankid_only_login": false,
      "two_factor_enabled": false,
      "email_notifications": true,
      "sms_notifications": false,
      "language": "sv",
      "timezone": "Europe/Stockholm",
      "created_at": "2026-02-10T00:00:00.000Z",
      "updated_at": "2026-02-10T00:00:00.000Z",
      "peppol_opt_out": false,
      "peppol_opt_out_reason": null,
      "peppol_opt_out_date": null
    }
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "preferences": {
          "type": "object",
          "properties": {
            "bankid_only_login": {
              "type": "boolean"
            },
            "client_id": {
              "type": "integer"
            },
            "created_at": {
              "type": "string"
            },
            "email_notifications": {
              "type": "boolean"
            },
            "id": {
              "type": "integer"
            },
            "language": {
              "type": "string",
              "enum": [
                "en",
                "sv"
              ]
            },
            "peppol_opt_out": {
              "type": "boolean"
            },
            "peppol_opt_out_date": {
              "type": "string",
              "nullable": true
            },
            "peppol_opt_out_reason": {
              "type": "string",
              "nullable": true
            },
            "sms_notifications": {
              "type": "boolean"
            },
            "timezone": {
              "type": "string"
            },
            "two_factor_enabled": {
              "type": "boolean"
            },
            "updated_at": {
              "type": "string"
            }
          }
        },
        "success": {
          "type": "boolean",
          "description": "True for successful responses."
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body Example 1

{
  "peppol_opt_out": false
}