Create the envelope

An envelope starts in draft. You can edit signers and fields freely until you send it.

POST /v1/envelopes

curl https://api.permissio.us/v1/envelopes \
-H "Authorization: Bearer $PERMISSIO_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 9b7e8f1c-3a8a-4d8b-8c34-2c4d4f8d1f72" \
-d '{
  "title": "NDA — Acme Corp",
  "source_url": "https://files.example.com/nda.pdf"
}'

The response includes the new id, e.g. env_01HZX9P7K5T2RMS2GZ9C3V8N4Q. Hold onto it for every subsequent call against this envelope.