Create a new user.

POST

https://demo.azuracast.com/api/admin/users

Create a new user.

curl -X POST 'https://demo.azuracast.com/api/admin/users' \
  -H 'X-API-Key: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "email": "demo@azuracast.com",
  "auth_password": "",
  "name": "Demo Account",
  "locale": "en_US",
  "show_24_hour_time": true,
  "two_factor_secret": "A1B2C3D4",
  "created_at": 1609480800,
  "updated_at": 1609480800,
  "roles": []
}'

const body = `{
  "email": "demo@azuracast.com",
  "auth_password": "",
  "name": "Demo Account",
  "locale": "en_US",
  "show_24_hour_time": true,
  "two_factor_secret": "A1B2C3D4",
  "created_at": 1609480800,
  "updated_at": 1609480800,
  "roles": []
}`;

const response = await fetch('https://demo.azuracast.com/api/admin/users', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "email": "demo@azuracast.com",
  "auth_password": "",
  "name": "Demo Account",
  "locale": "en_US",
  "show_24_hour_time": true,
  "two_factor_secret": "A1B2C3D4",
  "created_at": 1609480800,
  "updated_at": 1609480800,
  "roles": []
}'''

response = requests.post(
    'https://demo.azuracast.com/api/admin/users',
    data=body.encode('utf-8'),
    headers={
        'X-API-Key': 'YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "email": "demo@azuracast.com",
  "auth_password": "",
  "name": "Demo Account",
  "locale": "en_US",
  "show_24_hour_time": true,
  "two_factor_secret": "A1B2C3D4",
  "created_at": 1609480800,
  "updated_at": 1609480800,
  "roles": []
}

{
  "id": 0,
  "email": "demo@azuracast.com",
  "auth_password": "",
  "name": "Demo Account",
  "locale": "en_US",
  "show_24_hour_time": true,
  "two_factor_secret": "A1B2C3D4",
  "created_at": 1609480800,
  "updated_at": 1609480800,
  "roles": [],
  "links": {},
  "is_me": true
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

Body

application/json

emailstring

Example

demo@azuracast.com

auth_passwordstring

Example

namestring | null

Example

Demo Account

localestring | null

Example

en_US

show_24_hour_timeboolean | null

Example

true

two_factor_secretstring | null

Example

A1B2C3D4

created_atinteger

Example

1609480800

updated_atinteger

Example

1609480800

rolesArray<any>

Response

200OKHasAutoIncrementId & object & HasLinks & object

Success

Response fields application/json

idintegerrequiredread only

emailstring

Example

demo@azuracast.com

auth_passwordstring

Example

namestring | null

Example

Demo Account

localestring | null

Example

en_US

show_24_hour_timeboolean | null

Example

true

two_factor_secretstring | null

Example

A1B2C3D4

created_atinteger

Example

1609480800

updated_atinteger

Example

1609480800

rolesArray<any>

linksobjectread only

Show child attributes

[key: string]string

is_mebooleanrequired

Whether this user record represents the currently logged-in user.

Example

true

403ForbiddenApi_Error

Access denied.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

500Internal Server ErrorApi_Error

A generic exception has occurred.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

Authorization

ApiKeyapiKey in header

Docs by Sourcey