Skip to main content

Send your first envelope

Three calls take a PDF from raw upload to a signer's inbox: create the envelope, attach a signer, and send.

Create the envelopePOST /v1/envelopes
curl https://api.permissio.us/v1/envelopes \
-H "Authorization: Bearer $PERMISSIO_KEY" \
-H "Content-Type: application/json" \
-d '{
  "title": "Master Services Agreement",
  "source_url": "https://files.example.com/msa.pdf"
}'

The response includes an envelope id. Use it for the next two calls.

Attach a signerPOST /v1/envelopes/{id}/signers
curl https://api.permissio.us/v1/envelopes/$ENV_ID/signers \
-H "Authorization: Bearer $PERMISSIO_KEY" \
-H "Content-Type: application/json" \
-d '{
  "name": "Avery Lin",
  "email": "avery@example.com",
  "role": "signer"
}'
Send for signaturePOST /v1/envelopes/{id}/send
curl -X POST https://api.permissio.us/v1/envelopes/$ENV_ID/send \
-H "Authorization: Bearer $PERMISSIO_KEY" \
-H "Idempotency-Key: 9b7e8f1c-3a8a-4d8b-8c34-2c4d4f8d1f72"

After the third call the envelope moves to sent and the signer receives a sandbox signing link.