Account

Update account personalization

Set the invoice-emission language, PDF template and accent color of the company in one partial update; omitted fields keep their value. language is one of es, en, ca; pdf_template is a slug from the PdfTemplate catalog; accent_color is a #RRGGBB hex color. Returns the updated Account resource.

patch/companies/{company}/personalization

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/personalization
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Headers

Idempotency-Keystring
Example:01928f10-7c0e-7c4a-9b7d-2f8a6e3c1d4b

Client-generated opaque key (up to 255 characters; UUID v7 recommended) that makes retries safe: the first response is cached and replayed for repeats without re-executing the mutation. Reusing a key with a different body returns 422 idempotency_key_reused; the values of secret fields (password, secret…) count as part of the body, so retrying with a corrected secret under the same key is a different request, never the replay of the earlier answer. See the Idempotency guide.

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Request body

language'es' | 'en' | 'ca' | 'null' nullable

Account issuing language: es, en or ca.

pdf_template'classic' | 'modern' | 'minimal' | 'corporative' | 'premium' | 'null' nullable

Invoice PDF template (slug from the template catalog).

accent_colorstring nullable

PDF accent color in hexadecimal (#RRGGBB).

Response

Example response

{
  "data": {
    "object": "account",
    "company": {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
      "name": "Acme Corporation",
      "tax_id": "B12345674"
    },
    "plan": {
      "slug": "enterprise",
      "name": "Enterprise"
    },
    "addon": {
      "active": true,
      "in_grace": false,
      "expires_at": null
    },
    "api_key": {
      "id": "019e81ef-e1d4-7208-a51d-94c2c2a54a84",
      "name": "Producción",
      "prefix": "fact_live_1OSf9KdP",
      "scopes": [
        "account:read",
        "series:read",
        "series:write"
      ],
      "tier": "scale",
      "environment": "live",
      "created_at": "2026-01-15T09:30:00Z",
      "last_used_at": "2026-05-25T18:00:00Z",
      "expires_at": null
    },
    "personalization": {
      "pdf_capabilities": {
        "can_upload_logo": true,
        "can_upload_brand_image": true,
        "requires_attribution": true,
        "upgrade_plan": "empresario"
      },
      "language": "es",
      "pdf_template": "modern",
      "accent_color": "#1a73e8"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.