A Custom Quaderno account is almost completely invisible to the account holder. You —the platform— are responsible for all interactions with your user and configure all the account's settings, including all the information needed for tax calculations, programmatically.

With Custom accounts you can modify the connected account’s details and settings programatically through the API, including managing their tax settings and invoices.

Since Custom account holders can’t log into Quaderno, it’s up to you to build the onboarding flow, user dashboard, reporting functionality, and communication channels.

Note there’s an additional cost for active Custom accounts. A Custom account is considered active from the moment it's enabled on Quaderno to when it's disabled programmatically.

Creating a Custom account

We highly encourage testing this steps on our sandbox environment first. You can learn about Quaderno Sandbox features on its developer docs. URLs for Quaderno Sandbox starts with [sandbox-quadernoapp.com](<http://sandbox-quadernoapp.com>) and credentials are separate from production. Note all the examples below use production URLs instead.

At the bare minimum, use our Account API to create and connect a Custom account:

curl --request POST \\
  --url https://ACCOUNT_NAME.quadernoapp.com/api/accounts/ \\
  -u YOUR_API_KEY:x \\
  --header 'Content-Type: application/json' \\
  --data '{
    "business_name": "Big Bang Inc.",
    "email": "bigbang@example.com",
    "country": "US",
    "postal_code": "10001",
    "local_tax_id": "123456789",
    "default_product_type": "service",
    "default_tax_code": "ebook"

Since 09/16/21 you can also specify default_tax_code and default_product_type

The result of a successful API call is the user's account information and tokens:

  "id": 21791,
  "authentication": { // to be used to act on behalf of the new account
    "token_type": "Bearer",
    "access_token": "xxx", // expires on 25 days
    "refresh_token": "yyy" // does not expire on Custom accounts
  "business_name": "Big Bang Inc.",
  "country": "US",
  "created_at": 1632212259,
  "currency": "USD",
  "default_product_type": "service",
  "default_tax_code": "ebook",
  "email": "bigbang@example.com",
  "local_tax_id": "123456789",
  "state": "active",
  "subdomain": "ninive-xxxx", // the new ACCOUNT_NAME for your merchant
  "type": "custom"

Safely store the access_token and refresh_token in your database – You'll need those to Making API calls for connected accounts.

Access tokens for Custom accounts expires in 25 days. Refresh tokens for Custom accounts never expire. Keep reading to learn how to deactivate Custom accounts.

That's it! 🎉 Now you can use the Quaderno API on your user's behalf to calculate taxes, issue invoices, generate tax reports, and more.