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

---

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