API ReferenceService Accounts
Create Service Account
Create a new service account for machine-to-machine API access.
Endpoint
POST /v1/service-accountsBase URL: https://api-id.avnology.net
Authentication: API Key or OAuth token with admin:service-accounts:write scope
Request
curl -X POST https://api-id.avnology.net/v1/service-accounts \
-H "Authorization: Bearer ak_live_..." \
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable name (1--256 chars) |
description | string | No | Description of the service account's purpose |
owner_id | string | Yes | Human identity that owns this service account |
organization_id | string | No | Organization the service account belongs to |
Response
Success (201 Created)
{
"id": "sa_3c2d1e0f-9a8b-7c6d-5e4f-3a2b1c0d9e8f",
"name": "CI/CD Pipeline",
"description": "Automated user provisioning from GitHub Actions",
"owner_id": "usr_4f18acec-2712-4be7-a9af-b063b4f6deba",
"organization_id": "org_7a2b3c4d",
"active": true,
"create_time": "2026-04-08T12:00:00Z"
}Related
- Create API Key -- generate an API key for this account
- SDK:
client.admin.createServiceAccount({ name, ownerId })(TypeScript)