White-labeling with WaiverCat
On WaiverCat’s enterprise plan you can offer our eSignature features within your own platform! This includes:
Allowing your customers to create documents right on your site.
Providing an embedded version of the WaiverCat annotation tool.
Sending signature requests via email OR creating signature requests and distributing the links on your own.
Tracking your customers’ signed PDFs, and presenting these documents on your page.
First steps: authentication
Short lived tokens allow you to delegate WaiverCat functionality to your customers. If you are an approved enterprise client, you may use the
white-label endpoint to fetch a 64 character token; you will need your
API key to make the request. The token will expire within 20 minutes of it’s first usage, so we recommend requesting a new token at each stage in the document life cycle.
These tokens will be scoped to a domain and only browser requests from that origin will be accepted.
PDF upload delegation
The entire process for uploading a PDF on behalf of a customer is simple:
Request a new
white-labeltoken using your API key. We recommend that you pass along a
end_user_idparameter in this request. The end_user_id may be any string or number shorter than 64 digits. This will allow you to segment your clients’ documents from each other. All documents fetched with a scoped
white-labeltoken will have been created by that same
Within your client code, make a
POSTrequest to our
multipartrequest should contain a
formkey with mime-type PDF. WaiverCat will return the
Annotating from your application
When your customer is ready to annotate their document, i.e. prepare it to be signed, you
(Recommended) request a new
white-labeltoken when your user chooses to annotate the document. Remember to pass an
iframeinto your application that uses the following source:
https://<YOUR_SUBDOMAIN>.waivercat.com/documents/:doc_id/annotate?white-label=<WHITE_LABEL_KEY>. If you don’t have a custom subdomain yet, reach out to WaiverCat support at email@example.com.
The embedded site will handle all of the annotating and saving points!
Sending signature requests
See our standard API docs for sending eSignature requests.
White-label clients can optionally pass an
end_user_id when sending a signature request; this will ensure that the client can only send their own documents.
Tracking signature requests
See our standard API docs for fetching eSignature requests, complete or incomplete. Again, you may filter by
end_user_id, fetching only documents of a specific end user.
If you would like to receive active notifications via webhook when a form is signed, pass a
webhook_url to the document creation API call. For example, you might pass the same endpoint for all documents of a specific
WaiverCat is in the process of migrating our manual, internal white-label integration into a simple standard. If you have any questions integrating please send a message to firstname.lastname@example.org. We typically respond within a day. We also have developers available for hire to help you build your integrations.