Skip to main content

VanityCert Developer Documentation

Welcome to VanityCert's developer documentation. VanityCert provides automated SSL/TLS certificate provisioning for your custom domains through a simple API.

What is VanityCert?​

VanityCert automates the entire SSL certificate lifecycle:

  • DNS Validation - Verify domain ownership through DNS records
  • Certificate Issuance - Automatically request and provision SSL certificates
  • Certificate Monitoring - Track certificate status and expiry
  • Automatic Renewals - Renew certificates before expiration
  • Webhook Notifications - Real-time alerts for certificate events

Integration Methods​

1. Direct API Integration​

Use our REST API to manage domains and certificates programmatically.

curl -X POST https://app.vanitycert.com/api/domains \
  -H "X-API-KEY-ID: vc_pk_your_key_id" \
  -H "X-API-KEY: your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "app.yourdomain.com", "server_id": 123}'

View API Documentation →

2. JavaScript Widget​

Embed our widget to let your users provision SSL certificates directly on your website.

<script src="https://cdn.jsdelivr.net/npm/@vanitycert/widget@1"></script>
<script>
  VanityCert.init({
    target: '#ssl-widget',
    apiEndpoint: '/api/vanitycert-proxy',
    serverId: 123,
    userId: 'user-123'
  });
</script>

View Widget Documentation →

3. White-Label Portal​

Redirect your users to our customizable white-label portal with your branding.

https://app.vanitycert.com/portal/{your-org-token}

Common Use Cases​

SaaS Platforms​

Provision SSL certificates for customer custom domains automatically.

Example: A website builder letting customers use their own domains.

Multi-Tenant Applications​

Manage SSL certificates for multiple tenants or organizations.

Example: A CRM platform with customer-specific subdomains.

DevOps Automation​

Automate certificate provisioning in your CI/CD pipeline.

Example: Auto-provision certificates for preview environments.

How It Works​

  1. Create Domain - Add your domain via API or dashboard
  2. Configure DNS - Point your domain to VanityCert via CNAME
  3. Validation - We validate domain ownership (5-30 minutes)
  4. Issuance - Certificate is requested and provisioned (1-5 minutes)
  5. Monitoring - We monitor and auto-renew before expiration

Support​

Next Steps​

🚀 Getting Started

Create your first domain and provision an SSL certificate.

Get Started →

🔌 JavaScript Widget

Embed SSL provisioning directly on your website.

View Widget Docs →

🔔 Webhooks

Receive real-time notifications for certificate events.

Setup Webhooks →

💻 Code Examples

Integration examples in Node.js, PHP, Python, and more.

View Examples →