Create user

Create a username/password user account inside a Sign-In Context.

cURL

curl -X POST "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/up/create" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "alice.smith",
    "password": "Bx7-qMfeQ9"
  }'

200

{
  "username": "alice.smith",
  "password": "Bx7-qMfeQ9"
}

Creates a new username/password user. The Context’s Username and Password module must be enabled. Duplicate usernames are rejected at validation time.

Request

organizationId · string · required

Organization ID.

contextId · string · required

Sign-In Context ID.

x-auth-token · string · required

Context API key.

username · string · required

Username. Must be unique within the Context.

password · string · required

Password. Must satisfy the Context’s password policy.

cURL

curl -X POST "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/up/create" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "alice.smith",
    "password": "Bx7-qMfeQ9"
  }'

Response

username · string

The created user’s username. Echoes the request.

password · string

The user’s password. Echoes the request — keep the transport encrypted.

200

{
  "username": "alice.smith",
  "password": "Bx7-qMfeQ9"
}