POST
/
api
/
create_user_group
/

The End User Group API is now deprecated and has been replaced by the Customer API. Each End User Group entity corresponds to a Customer entity, with its user_group_id corresponding to a Customer customer_id.

This API method has been replaced by Get or Create Customer.

This endpoint gets or creates a new user group. If the user_group_id does not exist, a new user group will be created and information about the group will be sent back. If the user_group_id exists, no action will be taken but the same information about the group will be sent back. There will be a flag in the response indicating if a new user group was created.

Body

name
string

This is the name of the user group.

user_group_id
string

This is the ID you use to identify this user group in your database.

mapping
object

This is a JSON mapping of schema id to either the data source that this user group should be associated with or id of the datasource you provided when creating it.

is_demo_group
boolean

Set this boolean parameter to true to make data panels include a demo watermark for the user group. Demo user groups do not count towards paid user groups. Default value is false.

properties
object

This is a JSON object for properties assigned to this user group. These will be accessible through variables in the dashboards and SQL editor

Response

success
number

Indicates whether the call was successful. 1 if successful, 0 if not.

new_user_group
boolean

Indicates whether a new user group was created.

user_group
object

The contents of the user group