OAuth connection — field reference

Do not add a manual Authorization header on any HTTP request template that uses this connection — Hubhus injects the Bearer token automatically.

Create customer — request body

{
  "Customer": {
    "Name": "%lead_name%",
    "Address1": "%lead_street_address%",
    "ZipCode": "%lead_postal_code%",
    "City": "%lead_city_name%",
    "Phone1": "%lead_phone%",
    "Email": "%lead_email%",
    "OrganisationNumber": "{{personnummer}}",
    "Type": "PRIVATE"
  }
}

JSON map:

{{fortnox_customer_number}}=Customer.CustomerNumber

Adapt field names and placeholders to match the campaign's data fields. If the Hubhus data field is named differently, adjust the left side of the JSON map accordingly.

Create invoice — minimal request body

{
  "Invoice": {
    "ExternalInvoiceReference1": "%lead_id%",
    "CustomerNumber": "{{fortnox_customer_number}}",
    "DeliveryDate": "%event_start_date_db%",
    "InvoiceRows": [
      {
        "Description": "Arbejde",
        "DeliveredQuantity": 1,
        "Price": 100,
        "VAT": 25
      }
    ]
  }
}

JSON map:

{{fortnox_invoice_number}}=Invoice.DocumentNumber

Invoice med HouseWorkType — eksempel med alle tre linjetyper

{
  "Invoice": {
    "ExternalInvoiceReference1": "%lead_id%",
    "CustomerNumber": "{{fortnox_customer_number}}",
    "DeliveryDate": "%event_start_date_db%",
    "TaxReductionType": "rut",
    "InvoiceRows": [
      {
        "Description": "Transport",
        "DeliveredQuantity": 1,
        "Price": 1000,
        "HouseWork": false,
        "HouseWorkType": "OTHERCOSTS"
      },
      {
        "Description": "Rabat",
        "DeliveredQuantity": 1,
        "Price": -300,
        "HouseWork": false,
        "HouseWorkType": "EMPTYHOUSEWORK"
      },
      {
        "Description": "Arbejde",
        "DeliveredQuantity": 1,
        "Price": 2500,
        "HouseWork": true,
        "HouseWorkType": "GARDENING",
        "HouseWorkHoursToReport": 3
      }
    ]
  }
}

Setting HouseWork: false alone is not sufficient — Fortnox requires an explicit HouseWorkType value on every row to display the correct category in the Fortnox UI.

HouseWorkType — komplet oversigt / Komplett översikt

ROT (Reparation, Ombyggnad, Tillbyggnad)

RUT (Rengöring, Underhåll, Tvätt)

Grön teknik / Green technology

Særlig / Teknisk

Anbefalet produktionsopsætning

Create at minimum these data fields in Hubhus to support the integration:

fortnox_customer_number
fortnox_invoice_number
fortnox_status
fortnox_error

Use the JSON map on each template to write Customer.CustomerNumber → {{fortnox_customer_number}} and Invoice.DocumentNumber → {{fortnox_invoice_number}}.

Fejl og løsninger / Felmeddelanden

"Har inte behörighet för scope."

The connection is missing a required scope. Add invoice customer (or companyinformation if needed) to the connection scopes and reconnect.

"Ogiltigt kundnummer."

The invoice request is using a customer number that doesn't exist in Fortnox. Create the customer first via POST /3/customers, write back Customer.CustomerNumber via JSON map, and only then run the invoice request.

"Unable to log in. Access token or client secret missing."

The Fortnox connection is not selected on the HTTP request template, or the connection has expired and needs to be reconnected. Select the connection and verify it shows Connected. Do not set a manual Authorization header.