Developer API

Build with theMamaSign API

Integrate e-signatures into your application with our powerful REST API. Get started in minutes with comprehensive documentation and SDKs.

Get API KeyView Documentation

Get Started in Minutes

Our SDK makes it easy to integrate e-signatures into your application. Install the package, add your API key, and start sending documents for signature.

Simple REST API with JSON responses
Official SDKs for 6+ programming languages
Sandbox environment for testing
Comprehensive error handling
Real-time webhooks for events
example.js
const apiKey = process.env.MAMASIGN_API_KEY;

async function sendForSignature() {
  const res = await fetch('https://mamasign.com/api/v1/signing-requests', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
      'Idempotency-Key': crypto.randomUUID()
    },
    body: JSON.stringify({
      document_name: 'Service Agreement.pdf',
      document_data: 'https://example.com/service-agreement.pdf',
      signers: [
        {
          email: 'john@example.com',
          name: 'John Doe',
          order: 1,
          role: 'needs_to_sign'
        }
      ],
      message: 'Please sign this agreement.'
    })
  });

  const signingRequest = await res.json();
  console.log(signingRequest);
}

Built for Developers

Everything you need to build a great integration

RESTful API

Clean, intuitive REST API design with predictable resource-oriented URLs.

Secure by Default

Bearer API key authentication with scoped permissions and hashed keys.

Webhooks

Real-time event notifications for document status changes.

JSON Responses

All responses in JSON format with comprehensive error messages.

Rate Limiting

Generous rate limits with clear headers and upgrade options.

Full Documentation

Comprehensive docs with examples in multiple programming languages.

API Endpoints

Core endpoints to manage documents and signatures

GET/api/v1/me
POST/api/v1/signing-requests
GET/api/v1/signing-requests/{id}
POST/api/v1/signing-requests/{id}/remind
GET/api/v1/documents/{id}
GET/api/v1/audit-events
View Full API Reference
Webhooks

Real-Time Event Notifications

Get instant notifications when documents are viewed, signed, or completed. No polling required - we'll push events to your endpoint as they happen.

signing_request.sent - When a signing request is sent
signing_request.viewed - When a recipient opens a request
signing_request.signed - When a signature is added
signing_request.completed - When all active recipients are done
signing_request.declined - When a signer declines
Webhook Payload
{
  "event": "signing_request.completed",
  "created_at": "2026-08-23T10:30:00Z",
  "data": {
    "signing_request_id": "550e8400-e29b-41d4-a716-446655440000",
    "document_name": "Service Agreement.pdf",
    "completed_at": "2026-08-23T10:30:00Z",
    "completed_by": {
      "email": "john@example.com",
      "name": "John Doe"
    },
    "files": {
      "signed_pdf": {
        "url": "https://mamasign.com/api/v1/signing-requests/550e8400-e29b-41d4-a716-446655440000/download",
        "authentication": "bearer_api_key",
        "required_scope": "documents:read"
      },
      "completion_certificate": {
        "url": "https://mamasign.com/api/v1/signing-requests/550e8400-e29b-41d4-a716-446655440000/certificate",
        "authentication": "bearer_api_key",
        "required_scope": "documents:read"
      }
    }
  }
}

Official SDKs

Get up and running quickly with our official libraries

🟢

Node.js

npm install @mamasign/sdk
🐍

Python

pip install mamasign
💎

Ruby

gem install mamasign
🐘

PHP

composer require mamasign/sdk
☕

Java

implementation "com.mamasign:sdk:1.0.0"
🔵

Go

go get github.com/mamasign/mamasign-go

Ready to Start Building?

Get your free API key and start integrating e-signatures into your application today.

Get Free API KeyTalk to Sales