Developer Portal

Invoyo API

Integrate invoicing and self-collection into your application

Invoyo API lets you automate invoicing, payments, customer management, and collections. Use our REST API to build custom integrations.

Quickstart – create an invoice:

bash

curl -X POST https://api.invoyo.ai/api/external/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_123",
    "totalAmount": 150000,
    "currency": "NOK",
    "dueDate": "2025-03-01"
  }'

Authentication

All API calls require a valid API key sent as a Bearer token in the Authorization header.

Where do I find the API key?

Logg inn på Invoyo og gå til Innstillinger → API for å opprette og administrere dine API-nøkler.

bash

curl https://api.invoyo.ai/api/external/invoices \
  -H "Authorization: Bearer YOUR_API_KEY"

Store the API key securely. Never share it in frontend code or public repositories.

Fakturaer

Opprett, hent og administrer fakturaer

Betalinger

Spor innbetalinger og betalingsstatus

Kunder

Administrer kunderegisteret ditt

Inkasso

Egeninkasso og purreprosesser

Webhooks

Registrer og administrer webhook-endepunkter

Webhook events

When you register a webhook, you can choose which events to listen to. The following event types are available:

Event	Description
`invoice.created`	Faktura er opprettet
`invoice.sent`	Faktura er sendt til kunde
`invoice.paid`	Faktura er betalt
`invoice.overdue`	Faktura er forfalt
`payment.received`	Betaling er mottatt
`payment.matched`	Betaling er matchet mot faktura
`collect.case_created`	Inkassosak er opprettet
`collect.reminder_sent`	Purring er sendt
`collect.resolved`	Inkassosak er løst

Example webhook payload:

json

{
  "event": "invoice.paid",
  "timestamp": "2025-02-15T14:00:00Z",
  "data": {
    "invoiceId": "inv_abc123",
    "amount": 150000,
    "currency": "NOK",
    "paidAt": "2025-02-15T14:00:00Z"
  }
}

Error codes

Invoyo API uses standard HTTP status codes to indicate whether a request was successful.

Code	Description
`200`	OK – Forespørselen var vellykket
`201`	Created – Ressursen ble opprettet
`400`	Bad Request – Ugyldig forespørsel, sjekk parametere
`401`	Unauthorized – Manglende eller ugyldig API-nøkkel
`403`	Forbidden – Ingen tilgang til denne ressursen
`404`	Not Found – Ressursen ble ikke funnet
`409`	Conflict – Ressursen er i konflikt med nåværende tilstand
`422`	Unprocessable Entity – Valideringsfeil i data
`429`	Too Many Requests – For mange forespørsler, vent litt
`500`	Internal Server Error – Serverfeil, prøv igjen senere

Example error response:

json

{
  "error": {
    "code": "validation_error",
    "message": "Feltet 'totalAmount' er påkrevd",
    "details": [
      {
        "field": "totalAmount",
        "message": "Må være et positivt heltall (øre)"
      }
    ]
  }
}

Code examples

Here are examples of how to create an invoice in different languages:

bash

curl -X POST https://api.invoyo.ai/api/external/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_123",
    "totalAmount": 150000,
    "currency": "NOK",
    "dueDate": "2025-03-01",
    "lines": [
      {
        "description": "Konsulenttjenester",
        "quantity": 10,
        "unitPrice": 15000
      }
    ]
  }'

Ready to integrate?

Create an account and get your API key in minutes.

Create account Go to API settings