---
title: "Create Incident Memberships V1"
method: POST
path: "/v1/incident_memberships"
tags: ["Incident Memberships V1"]
---

# Create Incident Memberships V1

`POST /v1/incident_memberships`

## Request

- Base URL: `https:////api.incident.io`
- URL: `https:////api.incident.io/v1/incident_memberships`
- Auth: none declared
- TypeScript: <https://skmtc.dev/incident/apis/incident-io/docs/v1/incident_memberships/post.ts> (a function with typed inputs; its response is checked against the schema)

Makes a user a member of a private incident

## Request body

- IncidentMembershipsV1CreateRequestBody
  - `incident_id` string, required
  - `user_id` string, required

## Response `201`

Created response.

- IncidentMembershipsV1CreateResponseBody
  - `incident_membership` IncidentMembership, required
    - `created_at` string, date-time, required: When the membership was created
    - `id` string, required: Unique identifier of this incident membership
    - `incident_id` string, required: Unique identifier of the incident
    - `updated_at` string, date-time, required: When the membership was last updated
    - `user` UserV2, required
      - `email` string: Email address of the user.
      - `id` string, required: Unique identifier of the user
      - `name` string, required: Name of the user
      - `role` 'viewer' | 'responder' | 'administrator' | 'owner' | 'unset', required: DEPRECATED: Role of the user as of March 9th 2023, this value is no longer updated.
      - `slack_user_id` string: Slack ID of the user

---

[API](https://skmtc.dev/incident/apis/incident-io.md) - [All operations](https://skmtc.dev/incident/apis/incident-io/llms.txt) - [OpenAPI document](https://skmtc.dev/incident/apis/incident-io/revisions/602fc25ddd76?raw)