Quick Start

Get your first NotaryCam transaction running in 5 minutes.

What You Need

• API Credentials
• Node.js 18+ installed (or Python 3.8+ or .NET 6+)
• 5 minutes

1-Minute Setup

Install Client

JavaScript/Node.js

npm install axios

Python

pip install requests

C#/.NET

dotnet add package Newtonsoft.Json

Set Environment Variables

Create a .env file:

NOTARYCAM_PARTNER_ID=your-partner-id
NOTARYCAM_API_KEY=your-api-key
NOTARYCAM_API_SECRET=your-api-secret
NOTARYCAM_DEPARTMENT_ID=your-department-id  # Required
NOTARYCAM_WORKFLOW_ID=your-workflow-id      # Optional

** Tip:** You only need DEPARTMENT_ID - the system will automatically assign a default WORKFLOW_ID if not specified.

5-Minute Implementation

Copy & Run This Code

JavaScript/Node.js

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');
require('dotenv').config();

const BASE_URL = '{BASE_URL}';

async function quickStart() {
  try {
    // 1. Authenticate
    const auth = await axios.post(`${BASE_URL}/api/v4/authorize/`, {
      partnerId: process.env.NOTARYCAM_PARTNER_ID,
      apiKey: process.env.NOTARYCAM_API_KEY,
      apiSecret: process.env.NOTARYCAM_API_SECRET
    }, {
      headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
    });
    
    const token = auth.data.token;
    const headers = {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    };

    // 2. Create User
    const user = await axios.post(`${BASE_URL}/api/v4/users`, {
      departments: [process.env.NOTARYCAM_DEPARTMENT_ID],
      email: 'test@example.com',
      firstName: 'Test',
      lastName: 'User',
      phone: '+15551234567'
    }, { headers });

    // 3. Create Transaction
    const transaction = await axios.post(`${BASE_URL}/api/v4/transactions/`, {
      department: process.env.NOTARYCAM_DEPARTMENT_ID,  // Required
      participants: [{ user: user.data.user._id, role: 'signer' }],
      workflow: process.env.NOTARYCAM_WORKFLOW_ID  // Optional
    }, { headers });

    const txId = transaction.data.transaction._id;

    // 4. Upload Document
    const form = new FormData();
    form.append('documents', fs.createReadStream('./test.pdf'));
    form.append('documentData', JSON.stringify([
      { fileName: 'test.pdf', type: 'notarize' }
    ]));
    await axios.post(
      `${BASE_URL}/api/v4/transactions/${txId}/documents`,
      form,
      { headers: { 'Authorization': `Bearer ${token}`, ...form.getHeaders() } }
    );

    // 5. Activate
    await axios.put(`${BASE_URL}/api/v4/transactions/${txId}/activate`, {}, { headers });

    console.log(' Success! Transaction ID:', txId);
    console.log('Room URL:', transaction.data.transaction.participants[0].roomURL);

  } catch (error) {
    console.error(' Error:', error.response?.data || error.message);
  }
}

quickStart();

Python

import requests
import json
import os
from dotenv import load_dotenv

load_dotenv()
BASE_URL = '{BASE_URL}'

def quick_start():
    try:
        # 1. Authenticate
        auth = requests.post(
            f'{BASE_URL}/api/v4/authorize/',
            data={
                'partnerId': os.environ['NOTARYCAM_PARTNER_ID'],
                'apiKey': os.environ['NOTARYCAM_API_KEY'],
                'apiSecret': os.environ['NOTARYCAM_API_SECRET']
            },
            headers={'Content-Type': 'application/x-www-form-urlencoded'}
        )
        
        token = auth.json()['token']
        headers = {
            'Authorization': f'Bearer {token}',
            'Content-Type': 'application/json'
        }

        # 2. Create User
        user = requests.post(f'{BASE_URL}/api/v4/users', json={
            'departments': [os.environ['NOTARYCAM_DEPARTMENT_ID']],
            'email': 'test@example.com',
            'firstName': 'Test',
            'lastName': 'User',
            'phone': '+15551234567'
        }, headers=headers)

        # 3. Create Transaction
        transaction = requests.post(f'{BASE_URL}/api/v4/transactions/', json={
            'department': os.environ['NOTARYCAM_DEPARTMENT_ID'],  # Required
            'participants': [{'user': user.json()['user']['_id'], 'role': 'signer'}],
            'workflow': os.environ['NOTARYCAM_WORKFLOW_ID']  # Optional
        }, headers=headers)

        tx_id = transaction.json()['transaction']['_id']

        # 4. Upload Document
        files = {
            'documents': ('test.pdf', open('./test.pdf', 'rb'), 'application/pdf')
        }
        data = {
            'documentData': json.dumps([
                {'fileName': 'test.pdf', 'type': 'notarize'}
            ])
        }
        requests.post(
            f'{BASE_URL}/api/v4/transactions/{tx_id}/documents',
            files=files,
            data=data,
            headers={'Authorization': f'Bearer {token}'}
        )

        # 5. Activate
        requests.put(f'{BASE_URL}/api/v4/transactions/{tx_id}/activate', json={}, headers=headers)

        print(f' Success! Transaction ID: {tx_id}')
        print(f'Room URL: {transaction.json()["transaction"]["participants"][0]["roomURL"]}')

    except Exception as error:
        print(f' Error: {error}')

if __name__ == '__main__':
    quick_start()

What Just Happened?

You just:

1. Authenticated with the API
2. Created a test user
3. Created a transaction
4. Uploaded a test document
5. Activated the transaction

Total time: ~5 seconds
API calls: 5

Next Steps

Now that you've seen it work, learn how each step works in detail:

Deep Dive

• Authentication - Token management
• Your First Transaction - Detailed tutorial

Production Ready

• Webhook Integration - Real-time updates

Troubleshooting

Error running the code?

• Verify your .env file has all required variables

401 Unauthorized?

• Double-check your API credentials
• Verify Partner ID matches API Key and Secret
• Try sandbox environment first

Need help?

• Email: support@notarycam.com
• Docs: FAQ