Skip to main content
Start a provider authorization

Authorizations

Authorization
string
header
required

Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission.

Headers

X-Organization-Id
string

Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization.

Body

application/json
provider
enum<string>
required
Available options:
fortnox,
e_conomic
browser_nonce
string
required

Random 32-byte hex nonce the browser keeps in session storage until completion.

Pattern: ^[a-f0-9]{64}$
name
string

Name of the new integration.

Required string length: 1 - 120
integration_id
string<uuid>

Reconnect this integration instead of creating one.

fields
object

Values for the provider’s connection.fields, e.g. agreement_number.

Response

Where to send the browser.

url
string<uri>
required
expires_at
string<date-time>
required