---
title: "Create an incident responder"
method: POST
path: "/api/v2/incidents/{incident_id}/responders"
tags: ["Incidents"]
---

# Create an incident responder

`POST /api/v2/incidents/{incident_id}/responders`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/incidents/{incident_id}/responders`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `incident_write`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/incidents/:incident_id/responders/post.ts> (a function with typed inputs; its response is checked against the schema)

Add a responder to an incident.

## Path parameters

- `incident_id` string, required

## Request body

- IncidentResponderRequest: Request payload for creating an incident responder.
  - `data` IncidentResponderDataRequest, required: Incident responder data in a create request.
    - `relationships` IncidentResponderRelationshipsRequest, required: Relationships for creating an incident responder.
      - `user` IncidentResponderUserRelationship, required: Relationship to a user for a responder create request.
        - `data` IncidentResponderUserRelationshipData, required: A user relationship data object for creating a responder.
          - `id` string, uuid, required: The user identifier.
          - `type` string, required: The user resource type.
    - `type` 'incident_responders', required: Incident responder resource type.

## Response `201`

Created

- IncidentResponderResponse: Response with a single incident responder.
  - `data` IncidentResponderDataResponse, required: Incident responder data in a response.
    - `attributes` IncidentResponderDataAttributesResponse, required: Attributes of an incident responder in a response.
      - `created` string, date-time, required: Timestamp when the responder was created.
      - `external_id` string, nullable: The external ID of the responder.
      - `external_source` string, nullable: The external source of the responder.
      - `is_billable` boolean, required: Whether this responder counts toward billing.
      - `last_active` string, date-time, nullable: Timestamp when the responder was last active.
      - `meta` object, nullable: Additional metadata for the responder.
      - `modified` string, date-time, required: Timestamp when the responder was last modified.
    - `id` string, uuid, required: The responder identifier.
    - `relationships` IncidentResponderRelationships: Relationships for an incident responder.
      - `created_by` RelationshipToUser: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
      - `last_modified_by` RelationshipToUser: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
      - `role_assignments` IncidentResponderRoleAssignmentsRelationship: Relationship to role assignments for a responder.
        - `data` IncidentResponderRoleAssignmentRelationshipData[]: List of role assignment relationship data.
          - `id` string, uuid, required: The role assignment identifier.
          - `type` string, required: The role assignment resource type.
      - `user` NullableRelationshipToUser, nullable: Relationship to user.
        - `data` NullableRelationshipToUserData, nullable, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
    - `type` 'incident_responders', required: Incident responder resource type.
  - `included` IncidentUserData[]: Included related resources.
    - `attributes` IncidentUserAttributes: Attributes of user object returned by the API.
      - `email` string: Email of the user.
      - `handle` string: Handle of the user.
      - `icon` string: URL of the user's icon.
      - `name` string, nullable: Name of the user.
      - `uuid` string: UUID of the user.
    - `id` string: ID of the user.
    - `type` 'users': Users resource type.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/c555647b183a?raw)