Guide

Getting started

This guide takes you from no access to receiving webhooks and fetching your first delivery. Allow about 15 minutes.

Before you begin

  • Your company must have an account in Pholio.
  • You need a user with the company administrator role.
  • Your endpoint must be reachable from the internet over HTTPS.

1. Add a webhook endpoint

  1. Log in to Pholio, open your company page and select the API tab.
  2. Select Legg til webhook (Add webhook).
  3. Enter your HTTPS endpoint URL, for example https://integration.example.com/pholio/webhook.
  4. Choose the events you want: delivery_created, delivery_updated and/or editing_complete.
  5. Save, then copy the signing secret. It is shown only once.

Choose Test webhook in the webhook's action menu to send a webhook_test event to your endpoint. Every attempt is listed under Webhook-historikk (webhook history) with the status code your endpoint returned.

2. Request an API key

  1. On the same tab, select Bestill API-nøkkel (Request API key).
  2. Give the key a name and choose its scopes: delivery:read to fetch deliveries, delivery:upload to import images.
  3. Under Formål (Purpose), describe what the key is for and which system will use it, then send the request.
  4. Pholio reviews the request. You get an email when it is approved or rejected.
  5. When it is approved, select Hent API-nøkkel (Get API key) on the tab and copy the key. It starts with phw_ and can be collected only once.

Read Authentication for how keys and scopes work.

3. Make your first request

When a webhook arrives, its entityId is the delivery ID:

{
  "event": "delivery_created",
  "entityId": 123
}

Fetch that delivery with your API key:

curl "https://www.pholio.no/api/v1/deliveries/123" \
  --header "Authorization: Bearer $PHOLIO_API_KEY" \
  --header "Accept: application/json"

The response contains the address and matrikkel, customer, realtors, invoice recipient, gallery link, order lines and photos of the delivery:

{
  "data": {
    "id": 123,
    "order_number": 456,
    "clients_order_number": "EXT-1001",
    "address": {
      "address": "Example Street 1", "zipcode": "0123", "city": "Oslo",
      "matrikkel": { "municipality_number": "0301", "gardsnummer": 208, "bruksnummer": 112, ... }
    },
    "customer": { "id": 12, "name": "Example Eiendom AS", "orgnr": "987654321" },
    "realtors": [ ... ],
    "invoice_recipient": { "name": "Example Eiendom AS", "email": "invoice@example.com", ... },
    "gallery_url": null,
    "orderlines": [ ... ],
    "photos": [ ... ],
    "status": 2,
    "booking_status_id": 4,
    "created_at": "2026-10-08T09:00:00Z",
    "updated_at": "2026-10-08T09:32:00Z"
  }
}

Next steps