---
title: "Create Participant(s) by Envelope ID"
method: POST
path: "/sign/envelopes/{envelopeID}/participants"
tags: ["Sign"]
---

# Create Participant(s) by Envelope ID

`POST /sign/envelopes/{envelopeID}/participants`

## Request

- Base URL: `https://api.gonitro.dev`
- URL: `https://api.gonitro.dev/sign/envelopes/{envelopeID}/participants`
- Auth: HTTP bearer

The **Create Participant(s) by Envelope ID** endpoint adds one or more participants to a specified envelope.
Accepts either a single participant object or a bulk request with an 'items' array.
Participants are associated to the parent Envelope and can sign multiple fields in different documents.

When creating participants, the following limits apply:
  - Maximum participants: 200

## Path parameters

- `envelopeID` string, uuid, required

## Request body

- union
  - SingleParticipantRequest: Create a single participant
    - `email` string: The email address of the participant
    - `role` 'signer' | 'cc': Role of the participant. - `signer`: A participant with the signer role can have fields assigned to them in order to sign the documents in the envelope. - `cc`: A participant with the cc role has read-only access. They can view the documents but cannot interact with them, so you cannot assign fields to a cc participant.
    - `authentication` union: Participant authentication When inviting a participant to a Nitro Sign flow, you must define how they will authenticate before signing the document. There are two supported methods: - Access code: A static code that you provide to the participant. - SMS code: A dynamic code that is sent to the participant's phone number.
      - AccessCode: Access code
        - `accessCode` string: Access code. It must contain between 4-32 characters.
        - `type` 'AccessCode'
      - SMS: SMS
        - `countryCode` string: Country code. It must start with `+` and be followed by 1-4 digits. For example +1, +55, +598
        - `phoneNumber` string: Phone number. Enter digits only, without a country code or formatting characters.
        - `type` 'SMS'
  - BulkParticipantRequest: Create multiple participants wrapped in an items array
    - `items` ParticipantCreate[]: List of participants to create.
      - `email` string: The email address of the participant
      - `role` 'signer' | 'cc', required: Role of the participant. - `signer`: A participant with the signer role can have fields assigned to them in order to sign the documents in the envelope. - `cc`: A participant with the cc role has read-only access. They can view the documents but cannot interact with them, so you cannot assign fields to a cc participant.
      - `authentication` union: Participant authentication When inviting a participant to a Nitro Sign flow, you must define how they will authenticate before signing the document. There are two supported methods: - Access code: A static code that you provide to the participant. - SMS code: A dynamic code that is sent to the participant's phone number.
        - AccessCode: Access code
          - `accessCode` string: Access code. It must contain between 4-32 characters.
          - `type` 'AccessCode'
        - SMS: SMS
          - `countryCode` string: Country code. It must start with `+` and be followed by 1-4 digits. For example +1, +55, +598
          - `phoneNumber` string: Phone number. Enter digits only, without a country code or formatting characters.
          - `type` 'SMS'

## Response `200`

Multiple participants created successfully. Returns an object with an 'items' array containing all created participants.

- BulkParticipantResponse: Response containing multiple created participants wrapped in an items array
  - `items` Participant[], required: List of all participants created in this request. Each participant contains its unique ID and configuration.
    - `ID` string, uuid: The unique identifier of the participant
    - `email` string: The email address of the participant
    - `role` string: The role of the participant
    - `authentication` union: Participant authentication
      - AccessCode: Access code
        - `accessCode` string: Access code. It must contain between 4-32 characters.
        - `type` 'AccessCode'
      - SMS: SMS
        - `countryCode` string: Country code. It must start with `+` and be followed by 1-4 digits. For example +1, +55, +598
        - `phoneNumber` string: Phone number. Enter digits only, without a country code or formatting characters.
        - `type` 'SMS'

## Other responses

- `201`: Participant created successfully.
- `400`: Invalid request
- `401`: Unauthorized - Invalid or missing JWT token
- `404`: Envelope not found

---

[API](https://skmtc.dev/gonitro/apis/nitro-sign-public-api.md) - [All operations](https://skmtc.dev/gonitro/apis/nitro-sign-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gonitro/apis/nitro-sign-public-api/revisions/fc0d2e7e0460?raw)