API & webhooks

Developers

Send documents for signature from your product. Authenticate with an API key. Receive events on a webhook. Available on Business and Enterprise plans.

See pricing Contact us

How integration works

  1. 1. Choose Business or Enterprise

    API keys and webhooks are included on those plans.

  2. 2. Create an API key

    In your workspace: Settings → API. Keys start with ixk_.

  3. 3. Call the REST API

    Upload, place fields, send for signature. Recipients sign via a link; no YoDocu account needed.

  4. 4. Listen with webhooks

    Events such as document.sent and document.completed, verified with HMAC.

Authenticate every request

Send your key in the header. Do not use session cookies from the web app.

X-Api-Key: ixk_…

Base URL: your YoDocu API host (for example https://api.yourdomain.com).

Endpoint overview

A sample of what you can call. Full request and response schemas, scopes, and webhook verification are available on request.

Method Path Purpose
POST /api/v1/documents Upload a draft document
POST /api/v1/documents/{id}/recipients Set signers
POST /api/v1/documents/{id}/fields Place signature fields
POST /api/v1/documents/{id}/send Send for signature
GET /api/v1/documents/{id}/status Poll status
POST /api/v1/webhooks Register a webhook URL
POST /api/v1/templates/{id}/use Create a draft from a template 
curl -X POST "$BASE/api/v1/documents" \
  -H "X-Api-Key: $YODOCU_API_KEY" \
  -F "file=@contract.pdf" \
  -F "title=Vendor agreement"

Need the full API reference?

Contact us for complete endpoint documentation, webhook HMAC verification details, and the Postman collection.

Contact us See pricing

API keys and webhooks require the Business or Enterprise plan.