Agreement Developer API

curl https://yourdomain.com/api/agreements \
  -H "X-API-Key: agr_your_api_key_here"

curl https://yourdomain.com/api/agreements \
  -H "Authorization: Bearer eyJhbGciOiJ..."

{
  "success": false,
  "error": "Agreement not found"
}

const client = new AgreementSDK({ apiKey: 'agr_your_key' });

// Create a draft agreement
const { agreement } = await client.agreements.create({
  title: 'Contractor NDA — Acme Corp',
  content: '<h1>Non-Disclosure Agreement</h1><p>...</p>',
  signingOrder: 'parallel',
});

// Add signers
await client.agreements.addRecipient(agreement.id, {
  name: 'Jane Smith',
  email: 'jane@example.com',
  role: 'signer',
});

// Send for signatures
await client.agreements.send(agreement.id);
console.log('Agreement sent!', agreement.id);

const { content } = await client.ai.generate({
  prompt: 'NDA between Acme Corp and a freelance developer, 2-year term, California law',
  category: 'nda',
});

// Create the agreement with the generated content
const { agreement } = await client.agreements.create({
  title: 'AI-Generated NDA',
  content,
});

// List templates
const { data: templates } = await client.templates.list({ category: 'nda' });

// Create a draft from the first matching template
const { agreement } = await client.templates.useAsAgreement(templates[0].id);

// In Node.js
const url  = client.agreements.downloadUrl(agreement.id);
const resp = await fetch(url, { headers: { 'X-API-Key': 'agr_your_key' } });
const buffer = await resp.arrayBuffer();
require('fs').writeFileSync('signed.pdf', Buffer.from(buffer));

import requests

API_KEY = "agr_your_key"
BASE    = "https://yourdomain.com/api"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

# Create agreement
agreement = requests.post(f"{BASE}/agreements", json={
    "title": "Contractor NDA",
    "content": "<h1>NDA</h1><p>...</p>",
}, headers=HEADERS).json()["agreement"]

# Add recipient
requests.post(f"{BASE}/agreements/{agreement['id']}/recipients", json={
    "name": "Jane Smith",
    "email": "jane@example.com",
    "role": "signer",
}, headers=HEADERS)

# Send
requests.post(f"{BASE}/agreements/{agreement['id']}/send", headers=HEADERS)
print("Sent:", agreement["id"])

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// Express example
app.post('/webhooks/agreement', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-agreement-sig'];
  if (!verifyWebhook(req.body, sig, process.env.WEBHOOK_SECRET)) {
    return res.status(401).end();
  }
  const event = JSON.parse(req.body);
  console.log('Event:', event.event, event.agreementId);
  res.status(200).end();
});

{
  "event": "agreement.completed",
  "agreementId": "a1b2c3d4-...",
  "timestamp": "2025-05-20T14:32:00Z",
  "data": {
    "id": "a1b2c3d4-...",
    "title": "Contractor NDA",
    "status": "completed",
    "completedAt": "2025-05-20T14:32:00Z",
    "recipients": [
      { "name": "Jane Smith", "email": "jane@example.com", "status": "signed" }
    ]
  }
}