Workspace
Connectors and Webhooks
Event delivery into your systems. The full webhook event list, HMAC signing, retries, and integrations.
Docshark talks to your stack two ways: connectors that pull things in, and webhooks that push events out.
Webhooks
Create endpoints under settings → webhooks. Each subscription takes:
- URL. Must be HTTPS.
- Events. At least one, from the list below.
- Label. A name for the endpoint (up to 120 characters).
- Secret, generated at creation, shown once, encrypted at rest. Store it immediately, it signs every delivery.
Event types
| Event | Fires when |
|---|---|
ENVELOPE_SENT | An envelope goes out. |
ENVELOPE_DELIVERED | A recipient's email lands. |
ENVELOPE_VIEWED | A recipient opens the document. |
ENVELOPE_SIGNED | A recipient signs. |
ENVELOPE_DECLINED | A recipient declines. |
ENVELOPE_COMPLETED | Everyone is done; the document seals. |
ENVELOPE_EXPIRED | The envelope's expiry passes unsigned. |
ENVELOPE_VOIDED | You void the envelope. |
ENVELOPE_REMINDED | A reminder goes out. |
ENVELOPE_CORRECTED | An active envelope is corrected. |
FORM_SUBMITTED | A web form gets a response. |
POWERFORM_ACTIVATED | A Power Form completion occurs. |
OBLIGATION_DUE_SOON | A tracked obligation approaches its date. |
OBLIGATION_OVERDUE | An obligation passes unresolved. |
Delivery
- Signing. Payloads are HMAC-signed with your endpoint's secret; verify the signature before trusting the body.
- Timeout. Deliveries wait up to 10 seconds; slow endpoints count as failures.
- Failure threshold. Ten consecutive failures trip the endpoint's failure state; fix the endpoint and re-enable it.
- Payloads. The event type, the envelope/form/obligation identifiers, and the actor/timestamp context.
Connectors
- Google Drive. Import files straight into your library; connect once, browse Drive from the upload picker.
Building on events
Webhooks drive the integrations Docshark does not ship: push ENVELOPE_COMPLETED into your CRM to flip a deal stage, OBLIGATION_OVERDUE into your alerting, FORM_SUBMITTED into your intake pipeline. The event list above is the contract. Subscribe to what your workflow needs, ignore the rest.