Skip to main content
POST
/
sign
/
envelopes
/
{envelopeID}
/
participants
Create Participant by Envelope ID
curl --request POST \
  --url https://api.gonitro.dev/sign/envelopes/{envelopeID}/participants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "<string>",
  "role": "signer",
  "authentication": {
    "type": "AccessCode",
    "accessCode": "<string>"
  }
}'
{
  "ID": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email": "<string>",
  "authentication": {
    "type": "AccessCode",
    "accessCode": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
envelopeID
string<uuid>
required

A unique UUIDv4 string that identifies the envelope in the Nitro system.

Body

application/json

Request to create a new participant

​
role
enum<string>
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.
Available options:
signer,
cc
​
email
string

The email address of the participant

​
authentication
object

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.
  • Access Code
  • SMS

Response

Participant created successfully

​
ID
string<uuid>

The unique identifier of the participant

​
email
string

The email address of the participant

​
authentication
object

Participant authentication Access code

  • Access Code
  • SMS
⌘I