Create API key - NetSapiens API v2

Creates an API key for machine-to-machine access and returns its secret key once. Store it securely: it is never shown again. Requires Reseller or Super User scope, or an API key with can-create-keys set to yes, and you cannot create a key above your own scope.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Key created. The body includes the secret key and a notes reminder. This is the only response that ever shows key. Allow a moment before the key authenticates on every server.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴500Server Error

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/apikeys' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "description": "Billing export integration", "user-scope": "Office Manager", "reseller": "example-reseller", "domain": "example.com", "readonly": "yes", "can-create-keys": "no", "ip-address": "192.0.2.10,198.51.100.0/24", "allowed-models": [ "cdr2", "subscriber" ] }'

{ "notes": "This key needs to be kept secure and secret and will not be shown again so please note it down now!", "key": "{{api_key}}", "key-id": "nsd_EXAMPLE1", "description": "Billing export integration", "reseller": "example-reseller", "user": "*", "domain": "example.com", "readonly": "yes", "can-create-keys": "no", "allowed-models": [ "cdr2", "subscriber" ], "ip-address": "192.0.2.10,198.51.100.0/24", "user-scope": "Office Manager", "created-datetime": "2026-09-25T17:04:05+00:00" }