---
title: "Create a Team Member"
method: POST
path: "/v1/team_members"
tags: ["Team Members"]
---

# Create a Team Member

`POST /v1/team_members`

Create a TeamMember using this action. It requires a JSON object containing an TeamMember.

## Request body

- object
  - `name` string, required — The name of the TeamMember user.
  - `email` string, required — The email address of the TeamMember user.
  - `department_permissions` object[], required — Array of department permissions for the team member.
    - `department_id` number, required — Department that the TeamMember should have the given permissions for.
    - `permissions` object, required
      - `designs` boolean, required — Should the TeamMember have access to Designs for the given Department?
      - `emails` boolean, required — Should the TeamMember have access to Email Settings and Email Templates for the given Department?
      - `credential_attributes` boolean, required — Should the TeamMember have access to Attributes for the given Department?
      - `analytics` boolean, required — Should the TeamMember have access to Analytics for the given Department?
      - `settings` boolean, required — Should the TeamMember have access to Settings for the given Department?
      - `role` string, required — "editor" or "viewer" access to Credential data in the Department.
      - `pathways` boolean — Should the TeamMember have access to Pathways for the given Department?
      - `groups` number[] — Limit the TeamMember access to specific Groups in the Department.

## Response `200`

OK

- object
  - `team_member` object
    - `id` number
    - `name` string
    - `email` string
    - `department_permissions` object[]
      - `department_id` number, required
      - `permissions` object, required
        - `designs` boolean, required
        - `emails` boolean, required
        - `credential_attributes` boolean, required
        - `analytics` boolean, required
        - `settings` boolean, required
        - `role` string, required
        - `pathways` boolean
        - `groups` number[]

## Changes

- **2026-05-05** `c3c9e1230224` — 2 info
  - added the new optional request property `department_permissions/items/permissions/pathways`
  - added the optional property `team_member/department_permissions/items/permissions/pathways` to the response with the `200` status
- **2025-09-08** `cac96b8772c3` — 1 info
  - endpoint added
- **2025-07-04** `a93800de3a85` — 1 breaking
  - api path removed without deprecation
- **2025-06-30** `98201e8dd1b4` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `ApiKeyAuth` was added to the API

[Change history](https://skmtc.dev/accredible/apis/accredible-credential-api/changes/v1/team_members/post.md)

---

[API](https://skmtc.dev/accredible/apis/accredible-credential-api.md) · [All operations](https://skmtc.dev/accredible/apis/accredible-credential-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/accredible/accredible-credential-api/revisions/f49e189c5767/schema)