---
title: "Add a new collaborator to an organization. Only the organization owner, a delegated team member with the editBrand permission, or a collaborator with editBrand on some of its brands may call this; that collaborator can only assign the brands they edit."
method: POST
path: "/v2/organizations/{organizationId}/collaborators/{email}"
tags: ["Organization Collaborators Api Service"]
---

# Add a new collaborator to an organization. Only the organization owner, a delegated team member with the editBrand permission, or a collaborator with editBrand on some of its brands may call this; that collaborator can only assign the brands they edit.

`POST /v2/organizations/{organizationId}/collaborators/{email}`

## Request

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

## Path parameters

- `organizationId` 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`

Collaborator added.

- 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.

## Other responses

- `400`: Invalid request body, or the target is already a collaborator or a team member of this organization.
- `403`: Caller is not a regular-user session, the organization permissions feature is disabled for the organization's owner, the organization's owner's plan does not qualify for an organization, the caller cannot manage the collaborators of this organization, or the target is the caller themselves.
- `404`: Organization not found, or its owner account could no longer be resolved.

---

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