Factuarea APIDevelopers
Contract

PDF capabilities on the account

The Account resource and the templates endpoint expose a read-only capabilities block: what the plan allows in document branding, which templates can be set and which plan unlocks the editor. Personalization updates outside the plan now return 403.

GET /v1/account and GET /v1/account/personalization/templates now include pdf_capabilities, a read-only block computed from the account's plan. It lets an integration enable or disable branding controls before calling PATCH /v1/account/personalization.

FieldMeaning
can_upload_logoThe account can upload a logo. can_upload_brand_image mirrors it.
can_customizeThe advanced PDF editor is available: accent color, advanced templates and layout options.
requires_attributionRendered documents keep the Factuarea attribution. true whenever can_customize is false.
available_templatesSlugs the account may set: all five with the editor, otherwise classic, modern and minimal.
upgrade_planPlan that unlocks the editor for an emprendedor account (empresario), or null.

PATCH /v1/account/personalization enforces the same rule: an accent_color or a template outside available_templates on an account without the editor returns 403 with code: feature_not_available_in_plan and applies no field. Values outside the catalog keep returning 422 with the accepted values.

Read Account personalization.

Updated endpoints3

EndpointDescription
GET/v1/accountRetrieve account details
GET/v1/account/personalization/templatesList available personalization templates
PATCH/v1/account/personalizationUpdate account personalization