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
- Log in to Pholio, open your company page and select the API tab.
- Select Legg til webhook (Add webhook).
- Enter your HTTPS endpoint URL, for example
https://integration.example.com/pholio/webhook. - Choose the events you want:
delivery_created,delivery_updatedand/orediting_complete. - 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
- On the same tab, select Bestill API-nøkkel (Request API key).
- Give the key a name and choose its scopes:
delivery:readto fetch deliveries,delivery:uploadto import images. - Under Formål (Purpose), describe what the key is for and which system will use it, then send the request.
- Pholio reviews the request. You get an email when it is approved or rejected.
- 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
- Verify webhook signatures before you trust a request.
- Browse every endpoint and field in the API reference.
