---
title: "POST /v2/authorization/{userId}/roles"
method: POST
path: "/v2/authorization/{userId}/roles"
tags: ["Brand Roles Api Service"]
---

# POST /v2/authorization/{userId}/roles

`POST /v2/authorization/{userId}/roles`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/authorization/{userId}/roles`
- Auth: none declared

## Path parameters

- `userId` integer, required

## Request body

- CreateBrandRoleRequest
  - `name` string, required
  - `description` string
  - `color` string, required
  - `actions` BrandRoleActions, required
    - `viewAnalytics` boolean
    - `viewInbox` boolean
    - `viewPlanner` boolean
    - `viewAds` boolean
    - `viewSmartlinks` boolean
    - `fullAccessReports` boolean
    - `fullAccessInbox` boolean
    - `fullAccessPlanner` boolean
    - `fullAccessAds` boolean
    - `fullAccessSmartlinks` boolean
    - `fullAccessHashtagTracker` boolean
    - `editBrand` boolean
    - `schedulePosts` boolean
    - `publishPosts` boolean
    - `approvePosts` boolean
    - `viewCondensedAnalytics` boolean
    - `fullAccessDashboards` boolean
    - `viewDashboards` boolean
    - `editFlow` boolean
    - `viewFlow` boolean
    - `fullAccessStudio` boolean
  - `organizationActions` OrganizationRoleActionsDto: Organization-level permissions granted by a brand role, on top of the per-brand actions. Never null in a read response - a role that never had organization permissions set is reported with every field false.
    - `manageBrands` boolean: Whether the role can create and manage brands at the organization level.
    - `manageRoles` boolean: Whether the role can create and manage other brand roles at the organization level.
    - `manageTeamMembers` boolean: Whether the role can manage team members at the organization level.
    - `manageAgencyConfig` boolean: Whether the role can manage the agency configuration.
    - `manageAgencyClients` boolean: Whether the role can manage agency clients.

## Response `200`

OK

- JsonOkResponseBrandRole
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` BrandRole
    - `id` integer
    - `userId` integer, required
    - `name` string, required
    - `description` string
    - `color` string
    - `type` string
    - `assignable` boolean
    - `teamMemberOnly` boolean
    - `deletedDate` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `deleted` boolean
    - `actions` BrandRoleActions, required
      - `viewAnalytics` boolean
      - `viewInbox` boolean
      - `viewPlanner` boolean
      - `viewAds` boolean
      - `viewSmartlinks` boolean
      - `fullAccessReports` boolean
      - `fullAccessInbox` boolean
      - `fullAccessPlanner` boolean
      - `fullAccessAds` boolean
      - `fullAccessSmartlinks` boolean
      - `fullAccessHashtagTracker` boolean
      - `editBrand` boolean
      - `schedulePosts` boolean
      - `publishPosts` boolean
      - `approvePosts` boolean
      - `viewCondensedAnalytics` boolean
      - `fullAccessDashboards` boolean
      - `viewDashboards` boolean
      - `editFlow` boolean
      - `viewFlow` boolean
      - `fullAccessStudio` boolean
    - `organizationActions` OrganizationRoleActionsDto, required: Organization-level permissions granted by a brand role, on top of the per-brand actions. Never null in a read response - a role that never had organization permissions set is reported with every field false.
      - `manageBrands` boolean: Whether the role can create and manage brands at the organization level.
      - `manageRoles` boolean: Whether the role can create and manage other brand roles at the organization level.
      - `manageTeamMembers` boolean: Whether the role can manage team members at the organization level.
      - `manageAgencyConfig` boolean: Whether the role can manage the agency configuration.
      - `manageAgencyClients` boolean: Whether the role can manage agency clients.
    - `assignedUsersCount` integer
    - `assignedEnabledCount` integer
    - `assignedDisabledCount` integer

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)