---
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`

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.net/gonitro/apis/nitro-sign-public-api.md) · [All operations](https://skmtc.net/gonitro/apis/nitro-sign-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gonitro/nitro-sign-public-api/revisions/26e3043a365b/schema)