Create or update a service connection

POST

/api/identity/connections

Creates or updates (upserts) a service connection for a given service type and environment. Test user fields are preserved when omitted, since the raw national identity number is never round-tripped by clients.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Connection saved

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/identity/connections' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "service_type": "vipps_login",
    "environment": "production",
    "display_name": "Example AS Vipps",
    "credentials": {
        "client_id": "abc123",
        "client_secret": "secret",
        "subscription_key": "subkey",
        "msn": "123456"
    }
}'

Response Example

200 - Success

{
    "success": true,
    "connection": {
        "id": "11111111-1111-1111-1111-111111111111",
        "service_type": "vipps_login",
        "environment": "production",
        "display_name": "Example AS Vipps",
        "is_active": true
    }
}

Modified at 2026-07-08 19:01:40

List service connections

Delete a service connection