Skip to content

API & webhooks

Connect Waqqa' to your systems: create signature envelopes from your own software, receive every signing event as it happens, and fetch the signed copy and its audit trail.

Requests today
4,218
Error rate
0.3%
Latency (p95)
182 ms
Rate limit
600 requests / minute
POST/api/v1/envelopes
Requesthttps://contract-management.system2030.com/api
curl -X POST https://contract-management.system2030.com/api/api/v1/envelopes \  -H "Authorization: Bearer wq_live_8F21_••••a91c" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 6c1f0e9a-po-4500018822" \  -d '{    "title": "IT Managed Services & SLA",    "contract_id": "CTR-2026-0142",    "document": { "template_id": "tpl-it-services", "version": 4 },    "signers": [      {        "name": "Sultan Al-Hamdan",        "email": "sultan.alhamdan@elm.sa",        "order": 1,        "channel": "email",        "verification": "nafath"      },      {        "name": "Noura Al-Qahtani",        "phone": "+966551234870",        "order": 2,        "channel": "whatsapp",        "verification": "nafath"      }    ],    "sequential": true,    "signature_level": "advanced",    "expires_in_days": 14,    "locale": "ar",    "webhook_url": "https://erp.horizon.sa/hooks/waqqa"  }'
Response
Press “Send request” to see the response

API keys

  • SAP integration — productionLive
    wq_live_8F21_••••••••a91cLast used: Today 10:05Expires: 2027-10-14
    envelopes:writecontracts:read
  • HR portalLive
    wq_live_3B7D_••••••••04eeLast used: Yesterday 15:22Expires: 2027-03-02
    envelopes:writeenvelopes:read
  • Power BI reportsLive
    wq_live_C410_••••••••7b2fLast used: Today 10:00Expires: 2027-01-18
    contracts:readaudit:read

Webhooks

Every event is HMAC-signed, with up to 8 retries over 24 hours