---
title: "POST /v2/authorization/{userId}/collaborators/{email}"
method: POST
path: "/v2/authorization/{userId}/collaborators/{email}"
tags: ["Brand Role Collaborators Api Service"]
---

# POST /v2/authorization/{userId}/collaborators/{email}

`POST /v2/authorization/{userId}/collaborators/{email}`

## Request

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

## Path parameters

- `userId` integer, required
- `email` string, required

## Request body

- BrandRoleAssignmentsRequest
  - `isDefaultEmail` boolean
  - `invitationCustomMessage` string
  - `assignments` BrandRoleAssignment[]
    - `id` integer
    - `blogId` integer
    - `userId` integer
    - `email` string
    - `blogName` string
    - `enabled` boolean
    - `roleId` integer
    - `roleName` string
  - `useNewActivationLink` boolean

## Response `200`

OK

- JsonOkResponseBrandRoleCollaborator
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` BrandRoleCollaborator
    - `userId` integer
    - `email` string
    - `fullName` string
    - `isUserActive` boolean
    - `lastSent` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `assignments` BrandRoleAssignment[]
      - `id` integer
      - `blogId` integer
      - `userId` integer
      - `email` string
      - `blogName` string
      - `enabled` boolean
      - `roleId` integer
      - `roleName` string
    - `profilePicture` string: Public URL of the collaborator's 400x400 profile picture. Absent when they have none, in which case the frontend renders its initials fallback.

---

[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)