RMail API

Back to Envelope

POST api/V1/Envelope/AddUpdateRecipient

Add/Update recipient in envelope.

Prerequisites

To be implemented

Request Information

Lorem ipsum

URI Parameters

None

Header Parameters

Header Description

Name Description Type
Content-Type This is a request content type application/json
Accept This is a response content type application/json
AuthToken This is user’s authorization token. example@example.com^296f1f85-35d4-4dd4-a350-67131c926546^rps^en-US

Note: From the Header parameters mentioned, “AuthToken” is not required for the below mentioned services.

  • Account/RegisterUser
  • Authentication/AuthenticateUser

Body Parameters

Recipient to add/update

Name Description Type Additional information
EnvelopeID Get/Set envelope id for which recipient to add. GUID None
RecipientType Get/Set type for which recipient to add. More info from Master API. GUID None
RecipientName Get/Set name for which recipient to add. string None
Email Get/Set email address for which recipient to add. string Data type: EmailAddress
Order Get/Set order for which recipient to add. integer None
RecipientID Get/Set ID for which recipient to add. To add recipient new ID to be provided and to update same ID needs to be provided. New ID can be taken from – https://www.guidgenerator.com/ GUID None

Request Formats

application/json, text/json
Sample:
{
"StatusCode": 100,
"StatusMessage": "sample string 1",
"Message": "sample string 2",
"EnvelopeID": "087f0e67-2337-4109-839f-71436bb95aca",
"RecipientID": "cfa6b1e1-fef0-4639-afa0-4013d33d2193",
"RecipientName": "sample string 5",
"SignerCount": 1
}
application/xml, text/xml
Sample:
<RecipientResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<StatusCode>Continue</StatusCode>
<StatusMessage>sample string 1</StatusMessage>
<Message>sample string 2</Message>
<EnvelopeID>087f0e67-2337-4109-839f-71436bb95aca</EnvelopeID>
<RecipientID>cfa6b1e1-fef0-4639-afa0-4013d33d2193</RecipientID>
<RecipientName>sample string 5</RecipientName>
<SignerCount>1</SignerCount>
</RecipientResponse>

Response Information

Resource Description

Retuns success/failure message

Name Description Type Additional information
StatusCode This will return Status Code. HttpStatusCode None.
StatusMessage This will return Status Message. string None.
Message This will return response message for corresponding status code. string None
EnvelopeID This will return Envelope Id. GUID None
RecipientID This will return Recipient ID. GUID None
RecipientName This will return Recipient Name string None
SignerCount integer None
application/json, text/json
Sample:
{
"StatusCode": 100,
"StatusMessage": "sample string 1",
"Message": "sample string 2",
"data": {}
}
application/xml, text/xml
Sample:
<ResponseMessage xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<StatusCode>Continue</StatusCode>
<StatusMessage>sample string 1</StatusMessage>
<Message>sample string 2</Message>
<data ></data>
</ResponseMessage>

Was this page helpful?