From endpoint to live HTTPS
with visible status

A complete guide to integrating SSLforSaaS into your platform — from account setup and DNS configuration to connecting your first customer domain.

3 steps
Project setup
Details, plan, hosted checkout
1 target
DNS handoff
Copied from Project Settings
Live state
Certificate status
DNS and provider validation tracked
1
Step 01

Create your SSLforSaaS account

Start by creating an account at sslforsaas.io/register. Billing details are collected only when you select a plan and continue to Stripe-hosted checkout. Once registered, you'll land in the app where you can create your first workspace and project.

Create your account Account first · hosted checkout after plan selection Company name hello@sslforsaas.com Password Create account → step 1 Hosted checkout After plan selection Account access Create your project

Once you're in, your dashboard gives you access to your project settings, domain list, certificate status, webhook configuration, and account settings. Generate project API keys only when you need server-to-server automation.

Your project API key is displayed once when you generate it from the selected project's API page. Copy it to a secure location immediately; rotate it from the same page when needed.
2
Step 02

Configure your application endpoint

Your application endpoint is where SSLforSaaS will forward customer traffic after the SSL certificate is applied. This is the hostname of your SaaS application — the server or load balancer that handles your customers' requests.

For example, if your customers visit app.customerdomain.com, SSLforSaaS will terminate SSL and proxy all traffic to your endpoint, such as app.yourplatform.com.

Your endpoint must be reachable over HTTP or HTTPS. SSLforSaaS will connect to it to proxy customer requests. Do not put a bare IP address here unless it is your application's actual address.

Navigate to Settings → Application Endpoint in your dashboard and enter your hostname:

Endpoint app.yourplatform.com
✓ Verified

SSLforSaaS will perform a quick connectivity check to verify your endpoint is reachable. Once verified, a green checkmark appears and you're ready for the next step.

  • Load balancer or hostname
    Use a hostname like app.yourplatform.com pointing to your load balancer or primary server.
  • Multiple regions
    If your infrastructure spans regions, use a GeoDNS-aware hostname. SSLforSaaS proxies to whatever your DNS resolves to.
  • HTTPS endpoint
    If your endpoint is already serving HTTPS, SSLforSaaS will connect to it securely and maintain end-to-end encryption.
3
Step 03

Copy your project DNS target

After project provisioning completes, Project Settings shows a project-specific CNAME target such as <project-id>.sslforsaas.io. This is the authoritative target to share with customers.

Do not substitute a shared sample hostname or IP address. Copy the exact value shown for the current project:

RecordSourceValueAction
CNAMEProject Settings<project-id>.sslforsaas.ioCopy target
Use current project state: The target is available only after the project has been provisioned. Keep the app open until the DNS summary shows the target as ready to share.

Open Project Settings → Network to copy the target and review the customer handoff instructions:

Customer CNAME target <project-id>.sslforsaas.io
✓ Ready to share
Customer domain app.clientsite.com CNAME record DNS lookup Project DNS target <project-id>.sslforsaas.io copied from the app resolves to SSLforSaaS managed edge provider-backed status Always use the project-specific target shown in the app
Customer-facing hostname: Customers browse their own domain. Their DNS record points to the project-specific SSLforSaaS target shown in Project Settings.
4
Step 04

Customer DNS setup — what to tell them

Once your setup is complete, you need to tell your customers how to point their custom domain to your platform. This involves adding a simple DNS record in their registrar. Provide them with clear instructions — the exact record depends on whether they're using an apex (root) domain or a subdomain.

For subdomains (e.g. app.customerdomain.com), your customers add a CNAME record:

TypeNameValueTTL
CNAMEapp<project-id>.sslforsaas.io300

For apex (root) domains (e.g. customerdomain.com), use a DNS provider that supports ALIAS, ANAME, or CNAME flattening to the same project target:

TypeNameValueTTL
ALIAS@<project-id>.sslforsaas.io300
Apex support depends on the customer's DNS provider. If it cannot flatten a hostname target, use a subdomain instead; do not substitute a hard-coded service IP.

After the domain is added and DNS resolves to the assigned target, provider-backed certificate provisioning begins. Timing depends on DNS and provider validation; wait for the app to report the domain as active before cutover.

Project-specific target
Subdomain CNAME
Provider-dependent apex
Visible activation status
5
Step 05

Integrate the API into your platform

While certificates are issued automatically after customer DNS points at SSLforSaaS, project owners can also queue domains through the project-scoped REST API when server-to-server automation is enabled for the project.

Base URL: https://api.sslforsaas.io — Project API requests require Authorization: Bearer {PROJECT_API_KEY}.
Queue a project domain — cURL
# Queue a customer domain under a project
curl -X POST https://api.sslforsaas.io/workspaces/{workspaceId}/projects/{projectId}/domains \
  -H "Authorization: Bearer {PROJECT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"domain_name":"app.customerdomain.com"}'

# Response: 202 Accepted
{
  "message": "Domain creation accepted and queued for asynchronous provisioning.",
  "domain_id": "65f000000000000000000001",
  "operation_id": "8b39f8a3-6f1b-4e85-8d4e-a8711a9e52d1",
  "provisioning": {
    "state": "queued",
    "certificate_status": "pending"
  }
}
SDK note: the first customer-facing integration path is direct REST. Do not depend on unpublished language SDKs.

Configure project webhooks in the dashboard to receive signed outbound events for supported workspace and user event types.

Webhook payload — workspace.domain_enabled
{
  "event_type": "workspace.domain_enabled",
  "scope": "workspace",
  "severity": "info",
  "workspace_id": "65f000000000000000000000",
  "project_id": "65f000000000000000000111",
  "payload": {
    "domain_id": "65f000000000000000000001",
    "domain_name": "app.customerdomain.com",
    "ssl_status": "active"
  },
  "occurred_at": "2026-04-10T09:41:30Z"
}
Webhook events available: workspace.domain_disabled · workspace.domain_enabled · workspace.domain_ssl_error · workspace.domain_limit_alert · workspace.project_provisioning_failed · user.team_invite · user.welcome
6
Step 06

Advanced configuration

Once your core setup is running, SSLforSaaS offers several advanced options to fine-tune how traffic is handled, secured, and routed. These are optional but recommended for production deployments.

  • Monitor certificate lifecycle
    Use the domain status shown in the app to track DNS validation, certificate issuance, and activation. Certificate-authority selection is provider-managed.
  • Follow provider-specific DNS guidance
    Use the exact target and validation instructions shown for the domain. If another Cloudflare account proxies the source record, provider restrictions may require DNS-only validation or a different handoff.
  • Custom request headers
    Attach custom HTTP headers to every proxied request — for example, pass a X-Customer-Domain header to your application so it knows which tenant is being served.
  • URL rewriting
    Configure path rewrites when proxying to your endpoint. For example, map all traffic from /app/* to a different backend path on your application server.
  • Project webhook notifications
    Configure project webhooks for supported lifecycle events and verify delivery from Project Settings. The current product does not expose self-service certificate upload.
Custom headers example: configure request headers from Project Settings when enabled for the project. The public project API does not expose a general settings endpoint in the current contract.
You're ready to add domains. SSLforSaaS manages provider-backed issuance and renewal for domains within the selected project's plan limits. Monitor lifecycle state and act on any DNS or validation errors shown in the app.
Ready to go live?

One project target.
Capacity defined by your plan.

Create your account and follow the guided setup. Provisioning time depends on DNS and provider validation.