Create New Notarization Session

post https://app.bluenotary.us/api/integrations/create_new_session

Body Params

notarization_id

string

required

Notarization Id Identifier from Vendor Side

customer_email

string

required

Email id of Customer

customer_first_name

string

required

First name of Customer

customer_last_name

string

required

Last Name of Customer

customer_middle_name

string

Middle Name of Customer

customer_authentication_type

string

The authentication mode the primary signer would be using when entering the singing session. Can be one of 'kba', 'biometrics' or 'skip'.

customer_address

string

Address of Customer

customer_birth_date

string

Date of birth of Customer in yyyy/mm/dd format

customer_city

string

City of Customer

customer_state

string

State of Customer

customer_zip

string

Zipcode of Customer

contact_method

string

Contact Method of customer for Notarization related updates. Email updates are sent by default

contact_details

string

If contact_method is email, provide emailid here. If contact_method is mobile, provide mobile number here

signingType

string

Defaults to ron

Signing type for the session. Defaults to 'ron'

session_type

string

Defaults to closing

The type of session to be used for signing. Default is closing

notarization_type

string

required

If Notarization needs to be performed immediately choose notarize_now. If Notarization needs to be performed at given date and time, choose notarize later

session_notary_email

string

This is a required field, when signingType is selected as 'ipen'. The notary email id of the user who is going to conduct the notarization for this session. Please make sure the business admin account you have has created the needed user as notary user

session_timing

string

When notarization_type is notarize_later, session_timing is required. the format used is as follows : "2022-07-13T13:47:10-06:30"

additional_signers

array of objects

If session has multiple signers, use this param to send those users's details

additional_signers

loan_number

string

If session_type is closing, you can specify the Loan Number for the signing

loan_session_type

string

If session_type is closing, you can specify the closing type from the list of allowed values

other_loan_session_type

string

If session_type is closing and loan_session_type is other, you can specify the exact loan session type in this field

other_details

string

Any other details required for the session can be added here

session_documents

array of objects

The documents which are needed to be notarized. The document file types like pdf. jpg, png are supported for notarizations

session_documents

document_templates

array of strings

List of template ids which you want to use for this session. You can find the template ids from "Templates" section of your business admin BlueNotary account

document_templates

notarizationTypes

string

Defaults to Acknowledgement

The type of notarization for this session for ex. Acknowledgement, Jurat etc. Provide comma separated values in case of multiple.

noOfBNWitness

int32

Number of witnesses you require to join this session from BlueNotary network notaries

witnessIdAuthRequired

boolean

If you want BlueNotary invited notaries to perform ID authentication to enter the session

witnessDetails

array of objects

If you want to use your own know witnesses, then add details to it and you can skip noOfBNWitness parameter in this case.

witnessDetails

state_specific_notary

string

In case you want to use notary from BlueNotary network then specify state name of the notary from you want to get the documents notarized (If Required). The state name should be a valid USA state.

final_documents_delivery_mode

string

Defaults to immediately

If you want the final signed document to not be sent to the signers upon completion of the notarization session, select notary_manual. By default, documents are delivered immediately upon session completion.

send_invite_after_pretagging

boolean

Defaults to false

If you do not want to send the session notarization invitation to all the respective signers immediately upon session creation, the invitation will be sent after the session notary, pretagger, or admin marks the document as pretagged.

Responses

Language

Credentials

Header

Request


xxxxxxxxxx
18
1
curl --location --request POST 'app.bluenotary.us/api/integrations/create_new_session' \
2
--header 'Authorization: bnkey-90bfb5b3153c9fa3fa87f845d04a23162aa0ccdabcc91585ec097021aberdsw3-ADSASBDFFDZ' \
3
--header 'Content-Type: application/x-www-form-urlencoded' \
4
--data-urlencode 'notarization_id=temp_notatization_id_124' \
5
--data-urlencode 'customer_email=rohcustomer@mailinator.com' \
6
--data-urlencode 'customer_first_name=Rohit' \
7
--data-urlencode 'customer_last_name=Patel' \
8
--data-urlencode 'customer_middle_name=AAA' \
9
--data-urlencode 'customer_address=ADDRESSS' \
10
--data-urlencode 'customer_city=Some City' \
11
--data-urlencode 'customer_state=Virginia' \
12
--data-urlencode 'customer_zip=23123' \
13
--data-urlencode 'contact_method=Mobile' \
14
--data-urlencode 'contact_details=234234234' \
15
--data-urlencode 'notarization_type=notarize_later' \
16
--data-urlencode 'session_timing=2022-08-09T22:00:10-06:00' \
17
--data-urlencode 'session_documents=[{name: "sample.pdf",base64Doc: "JVBERi0xLjMNCiXi48/TDQoNCjEgMCBvYmoNCjw8DQovVHlwZSAvQ2F0YWxvZw0KL091dGxpbmVzIDIgMCBSDQovUGFnZXMgMyAwIFINCj4+DQplbmRvYmoNCg0KMiAwIG9iag0KPDwNCi9UeXBlIC9PdXRsaW5lcw0KL0NvdW50IDANCj4+DQplbmRvYmoNCg0KMyAwIG9iag0KPDwNCi9UeXBlIC9QYWdlcw0KL0NvdW50IDINCi9LaWRzIFsgNCAwIFIgNiAwIFIgXSANCj4+DQplbmRvYmoNCg0KNCAwIG9iag0KPDwNCi9UeXBlIC9QYWdlDQovUGFyZW50IDMgMCBSDQovUmVzb3VyY2VzIDw8DQovRm9udCA8PA0KL0YxIDkgMCBSIA0KPj4NCi9Qcm9jU2V0IDggMCBSDQo+Pg0KL01lZGlhQm94IFswIDAgNjEyLjAwMDAgNzkyLjAwMDBdDQovQ29udGVudHMgNSAwIFINCj4+DQplbmRvYmoNCg0KNSAwIG9iag0KPDwgL0xlbmd0aCAxMDc0ID4+DQpzdHJlYW0NCjIgSg0KQlQNCjAgMCAwIHJnDQovRjEgMDAyNyBUZg0KNTcuMzc1MCA3MjIuMjgwMCBUZA0KKCBBIFNpbXBsZSBQREYgRmlsZSApIFRqDQpFVA0KQlQNCi9GMSAwMDEwIFRmDQo2OS4yNTAwIDY4OC42MDgwIFRkDQooIFRoaXMgaXMgYSBzbWFsbCBkZW1vbnN0cmF0aW9uIC5wZGYgZmlsZSAtICkgVGoNCkVUDQpCVA0KL0YxIDAwMTAgVGYNCjY5LjI1MDAgNjY0LjcwNDAgVGQNCigganVzdCBmb3IgdXNlIGluIHRoZSBWaXJ0dWFsIE1lY2hhbmljcyB0dXRvcmlhbHMuIE1vcmUgdGV4dC4gQW5kIG1vcmUgKSBUag0KRVQNCkJUDQovRjEgMDAxMCBUZg0KNjkuMjUwMCA2NTIuNzUyMCBUZA0KKCB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiApIFRqDQpFVA0KQlQNCi9GMSAwMDEwIFRmDQo2OS4yNTAwIDYyOC44NDgwIFRkDQooIEFuZCBtb3JlIHRleHQuIEFuZCBtb3JlIHRleHQuIEFuZCBtb3JlIHRleHQuIEFuZCBtb3JlIHRleHQuIEFuZCBtb3JlICkgVGoNCkVUDQpCVA0KL0YxIDAwMTAgVGYNCjY5LjI1MDAgNjE2Ljg5NjAgVGQNCiggdGV4dC4gQW5kIG1vcmUgdGV4dC4gQm9yaW5nLCB6enp6ei4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gQW5kICkgVGoNCkVUDQpCVA0KL0YxIDAwMTAgVGYNCjY5LjI1MDAgNjA0Ljk0NDAgVGQNCiggbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiApIFRqDQpFVA0KQlQNCi9GMSAwMDEwIFRmDQo2OS4yNTAwIDU5Mi45OTIwIFRkDQooIEFuZCBtb3JlIHRleHQuIEFuZCBtb3JlIHRleHQuICkgVGoNCkVUDQpCVA0KL0YxIDAwMTAgVGYNCjY5LjI1MDAgNTY5LjA4ODAgVGQNCiggQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgKSBUag0KRVQNCkJUDQovRjEgMDAxMCBUZg0KNjkuMjUwMCA1NTcuMTM2MCBUZA0KKCB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBFdmVuIG1vcmUuIENvbnRpbnVlZCBvbiBwYWdlIDIgLi4uKSBUag0KRVQNCmVuZHN0cmVhbQ0KZW5kb2JqDQoNCjYgMCBvYmoNCjw8DQovVHlwZSAvUGFnZQ0KL1BhcmVudCAzIDAgUg0KL1Jlc291cmNlcyA8PA0KL0ZvbnQgPDwNCi9GMSA5IDAgUiANCj4+DQovUHJvY1NldCA4IDAgUg0KPj4NCi9NZWRpYUJveCBbMCAwIDYxMi4wMDAwIDc5Mi4wMDAwXQ0KL0NvbnRlbnRzIDcgMCBSDQo+Pg0KZW5kb2JqDQoNCjcgMCBvYmoNCjw8IC9MZW5ndGggNjc2ID4+DQpzdHJlYW0NCjIgSg0KQlQNCjAgMCAwIHJnDQovRjEgMDAyNyBUZg0KNTcuMzc1MCA3MjIuMjgwMCBUZA0KKCBTaW1wbGUgUERGIEZpbGUgMiApIFRqDQpFVA0KQlQNCi9GMSAwMDEwIFRmDQo2OS4yNTAwIDY4OC42MDgwIFRkDQooIC4uLmNvbnRpbnVlZCBmcm9tIHBhZ2UgMS4gWWV0IG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gKSBUag0KRVQNCkJUDQovRjEgMDAxMCBUZg0KNjkuMjUwMCA2NzYuNjU2MCBUZA0KKCBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSB0ZXh0LiBBbmQgbW9yZSApIFRqDQpFVA0KQlQNCi9GMSAwMDEwIFRmDQo2OS4yNTAwIDY2NC43MDQwIFRkDQooIHRleHQuIE9oLCBob3cgYm9yaW5nIHR5cGluZyB0aGlzIHN0dWZmLiBCdXQgbm90IGFzIGJvcmluZyBhcyB3YXRjaGluZyApIFRqDQpFVA0KQlQNCi9GMSAwMDEwIFRmDQo2OS4yNTAwIDY1Mi43NTIwIFRkDQooIHBhaW50IGRyeS4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gQW5kIG1vcmUgdGV4dC4gKSBUag0KRVQNCkJUDQovRjEgMDAxMCBUZg0KNjkuMjUwMCA2NDAuODAwMCBUZA0KKCBCb3JpbmcuICBNb3JlLCBhIGxpdHRsZSBtb3JlIHRleHQuIFRoZSBlbmQsIGFuZCBqdXN0IGFzIHdlbGwuICkgVGoNCkVUDQplbmRzdHJlYW0NCmVuZG9iag0KDQo4IDAgb2JqDQpbL1BERiAvVGV4dF0NCmVuZG9iag0KDQo5IDAgb2JqDQo8PA0KL1R5cGUgL0ZvbnQNCi9TdWJ0eXBlIC9UeXBlMQ0KL05hbWUgL0YxDQovQmFzZUZvbnQgL0hlbHZldGljYQ0KL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcNCj4+DQplbmRvYmoNCg0KMTAgMCBvYmoNCjw8DQovQ3JlYXRvciAoUmF2ZSBcKGh0dHA6Ly93d3cubmV2cm9uYS5jb20vcmF2ZVwpKQ0KL1Byb2R1Y2VyIChOZXZyb25hIERlc2lnbnMpDQovQ3JlYXRpb25EYXRlIChEOjIwMDYwMzAxMDcyODI2KQ0KPj4NCmVuZG9iag0KDQp4cmVmDQowIDExDQowMDAwMDAwMDAwIDY1NTM1IGYNCjAwMDAwMDAwMTkgMDAwMDAgbg0KMDAwMDAwMDA5MyAwMDAwMCBuDQowMDAwMDAwMTQ3IDAwMDAwIG4NCjAwMDAwMDAyMjIgMDAwMDAgbg0KMDAwMDAwMDM5MCAwMDAwMCBuDQowMDAwMDAxNTIyIDAwMDAwIG4NCjAwMDAwMDE2OTAgMDAwMDAgbg0KMDAwMDAwMjQyMyAwMDAwMCBuDQowMDAwMDAyNDU2IDAwMDAwIG4NCjAwMDAwMDI1NzQgMDAwMDAgbg0KDQp0cmFpbGVyDQo8PA0KL1NpemUgMTENCi9Sb290IDEgMCBSDQovSW5mbyAxMCAwIFINCj4+DQoNCnN0YXJ0eHJlZg0KMjcxNA0KJSVFT0YNCg=="}]' \
18
--data-urlencode 'additional_signers=[{first_name: "Rohit", last_name: "Doe", email: "rvprvprvp7824+23423423421@gmail.com"}]'


xxxxxxxxxx
14
 
1
{
2
  "response": "Pass",
3
  "response_message": "Session Created Successfully",
4
  "notarization_id": "temp_notatization_id_124",
5
  "bn_session_id": "631b0dbdb25a08c4b848fc20",
6
  "bn_signing_url": "/sign-in?type=customer&email=rohcustomer@mailinator.com&password=$2a$05$zPY7sYrK7Y0.V2wu5fxZFOxNJ5y8nkMFESB/Wl.bpvjF4a9tpQxm2&loginViaEmail=true&sessionid=631b0dbdb25a08c4b848fc20&routetype=prepareDoc&autosubmit=true",
7
  "full_signing_url": "https://app.bluenotary.us/sign-in?type=customer&email=rohcustomer@mailinator.com&password=$2a$05$zPY7sYrK7Y0.V2wu5fxZFOxNJ5y8nkMFESB/Wl.bpvjF4a9tpQxm2&loginViaEmail=true&sessionid=631b0dbdb25a08c4b848fc20&routetype=prepareDoc&autosubmit=true",
8
  "additional_signers_signing_urls": [
9
    {
10
      "bn_signing_url": "/sign-in?type=customer&email=rvprvprvp7824+23423423421@gmail.com&password=$2a$05$oa9YUBK5PCQcOggvoIOeiu4ovWhZNOaZs0Rqd2MAn54cxnRla4wZK&loginViaEmail=true&sessionid=6414720b2afd51ba87d5309f&routetype=prepareDoc&autosubmit=true",
11
      "full_signing_url": "https://app.bluenotary.us/sign-in?type=customer&email=rvprvprvp7824+23423423421@gmail.com&password=$2a$05$oa9YUBK5PCQcOggvoIOeiu4ovWhZNOaZs0Rqd2MAn54cxnRla4wZK&loginViaEmail=true&sessionid=6414720b2afd51ba87d5309f&routetype=prepareDoc&autosubmit=true"
12
    }
13
  ]
14
}

200200

403403