POST/v1/envelopes/blueprint/official/confidentiality-agreement/

Confidentiality Agreement

Be protected while you share or receive confidential information with a one-way or two-way NDA.

An envelope using this blueprint may be created via the API or it may be created directly on the web using a form that has a one-to-one correspondence with the API.

The API to use a blueprint is identical from blueprint to blueprint except for two things. First, each blueprint has a unique context object that's passed in the API call. This is because the information needed to generate a Confidentiality Agreement is different than the information needed to generate an Independent Contractor Agreement, for example.

Second, a blueprint may sometimes call for you to pass in the parties separately from the context, but that depends on the shape of that blueprint's context. This Confidentiality Agreement blueprint does not require a parties property.

Request Body

Name
name
Type
string
required
Description
The name of the envelope. Limited to 254 characters that are alphanumeric, spaces, numbers, or symbols.
Name
context
Type
object
required
Description
An object containing the specific information required to render the blueprint. The shape of this object depends on which blueprint is being used.
Since this is an official blueprint, the reference on the shape of their context is provided in this documentation.
Name
webhook_url
Type
string
Description
The URL where Magistrate will POST webhooks related to this envelope. If this is provided, the API will immediately POST a webhook of type webhook_url_verification to the endpoint, and if it does not return a 2xx response within a couple seconds, the whole API call fail with a 400 response.
Name
autosign
Type
boolean
Description
If autosign is true, any signatures belonging to the creator of the envelope will be signed automatically. The creator will not receive an email soliciting their signature since they will have already signed.
This is ignored if the action is draft. This is also ignored if the creator of the envelope is not also a signatory.
Name
suppress_emails
Type
string
Description
If provided, it must be the string creator. If this is provided, the creator of the envelope will not receive any emails related to the envelope.
Name
action
Type
string
required
Description
One of the following strings: send or draft.
send will generate an envelope and send it for signature to all parties in one step.
draft will generate an envelope and save it as a draft. To make any edits or send it for signature, you must log into the web user interface.

Request

POST

/v1/envelopes/blueprint/official/confidentiality-agreement/

curl "https://api.getmagistrate.com/v1/envelopes/blueprint/official/confidentiality-agreement/"  \
  -H "Authorization: Token d0b0b4628e184832b1b0bc1e93fbd487" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Confidentiality Agreement",
    "context": {
      "basic": {
        "date": "2022-06-01",
        "favor": "neutral",
        "mutual": "Mutual",
        "term": 24,
        "governing_law": "CA",
        "entire_agreement": true
      },
      "party1": {
        "name": "Magistrate Inc.",
        "email": "harry@getmagistrate.com",
        "is_entity": true,
        "authorized_human": {
          "name": "Harry Khanna",
          "title": "Chief Executive Officer"
        },
        "address": {
          "address": "641 S Street NW",
          "address2": "Ste. 300",
          "city": "Washington",
          "state": "DC",
          "zip": "20001",
          "attn": "Harry Khanna, General Counsel"
        },
        "notice_email": "notices@getmagistrate.com"
      },
      "party2": {
        "name": "Lisa Vedernikova Khanna",
        "is_entity": false,
        "email": "lisa@getmagistrate.com",
        "address": {
          "address": "123 Bedford St.",
          "city": "Brooklyn",
          "state": "NY",
          "zip": "11211"
        }
      },
      "litigation": {
        "state": "CA",
        "locality": "County of Santa Clara",
        "exclusive_jurisdiction": true
      }
    },
    "webhook_url": "https://your-domain.example.com/webhooks/",
    "action": "send"
  }'

Context

This is the context specific to this blueprint. It is the object that you pass to the context property of the request body.

Name
basic
Type
object
required
Description
This is basic information about the agreement.
Basic Information Expand
Name
party1
Type
object
required / disallowed sometimes
Description
Information about the first party.
Required if basic.mutual is equal to Mutual. Must not be provided if basic.mutual is not equal to Mutual.
Party 1 Expand
Name
party2
Type
object
required / disallowed sometimes
Description
Information about the second party.
Required if basic.mutual is equal to Mutual. Must not be provided if basic.mutual is not equal to Mutual.
Party 2 Expand
Name
disclosing_party
Type
object
required / disallowed sometimes
Description
Information about the party disclosing the confidential information.
Required if basic.mutual is not equal to Mutual. Must not be provided if basic.mutual is equal to Mutual.
Disclosing Party Expand
Name
receiving_party
Type
object
required / disallowed sometimes
Description
Information about the party receiving the confidential information.
Required if basic.mutual is not equal to Mutual. Must not be provided if basic.mutual is equal to Mutual.
Receiving Party Expand
Name
litigation
Type
object
required
Description
Things that happen if there are disputes.
Litigation Expand

{
  "basic": {
    "date": "2022-06-01",
    "favor": "neutral",
    "mutual": "Mutual",
    "term": 24,
    "governing_law": "CA",
    "entire_agreement": true
  },
  "party1": {
    "name": "Magistrate Inc.",
    "email": "harry@getmagistrate.com",
    "is_entity": true,
    "authorized_human": {
      "name": "Harry Khanna",
      "title": "Chief Executive Officer"
    },
    "address": {
      "address": "641 S Street NW",
      "address2": "Ste. 300",
      "city": "Washington",
      "state": "DC",
      "zip": "20001",
      "attn": "Harry Khanna, General Counsel"
    },
    "notice_email": "notices@getmagistrate.com"
  },
  "party2": {
    "name": "Lisa Vedernikova Khanna",
    "is_entity": false,
    "email": "lisa@getmagistrate.com",
    "address": {
      "address": "123 Bedford St.",
      "city": "Brooklyn",
      "state": "NY",
      "zip": "11211"
    }
  },
  "litigation": {
    "state": "CA",
    "locality": "County of Santa Clara",
    "exclusive_jurisdiction": true
  }
}

Response

If the request is successful, the endpoint will return a status code of 201 Created.

The response body will be the new envelope object.