GoAdmio
GoAdmio Documentation

Spaceship API

From the GoAdmio knowledge base.

Spaceship API

This page explains the Spaceship API integration in GoAdmio. It connects GoAdmio to your Spaceship registrar account so the panel can automatically change a domain's nameservers to Cloudflare — completing the automation chain that adds all DNS records to Cloudflare without manual steps.

Location: Admin Panel → Domain API → Spaceship API


Overview

GoAdmio's DNS automation has two halves:

  1. Cloudflare — hosts the DNS zone and creates all records (A, AAAA, MX, SPF, DKIM, DMARC, autodiscover, autoconfig)
  2. The registrar — must point the domain's nameservers at Cloudflare so Cloudflare becomes authoritative
The Spaceship API integration handles step 2 for domains registered at Spaceship. When a domain is added to Cloudflare via GoAdmio, the panel can also update its nameservers at Spaceship — so the domain becomes live for both web and email with one command.

Without the Spaceship API, the customer must manually change nameservers in the Spaceship control panel — a step that is easy to forget and causes hours of "why isn't my site live?" tickets.

> Note: The Spaceship API is one of several registrar integrations in GoAdmio. See Dynadot API and Reseller Club API for other registrars. All of them require the Cloudflare API to be configured first — Cloudflare is where the DNS records live.


How the Automation Works

When you run /go/dns domain.com on a domain registered at Spaceship, GoAdmio:

  1. Creates the zone in Cloudflare — via the Cloudflare API
  2. Adds all DNS records — A, AAAA, MX, SPF, DKIM, DMARC, autodiscover, autoconfig
  3. Reads the Cloudflare nameservers assigned to the zone
  4. Updates the nameservers at Spaceship — via the Spaceship API
  5. Verifies the change (if supported)
The domain is now live for web and email — no manual DNS work, no copy-pasting nameservers.

> Warning: Nameserver changes at the registrar can take minutes to 48 hours to propagate worldwide, depending on the TLD and the old TTL. The automation removes the manual step, but it does not speed up propagation.


What the Page Shows

| Field | Description |
|---|---|
| API Key | Your Spaceship API key |
| API Secret (if required) | Your Spaceship API secret |
| Sandbox Mode (if available) | Whether to use Spaceship's sandbox for testing |
| Save / Verify | Apply and test the credentials |
| Status | Whether the credentials are valid |

> Note: The exact fields depend on Spaceship's current API authentication model and your GoAdmio version. Spaceship uses API keys generated in its control panel.


Prerequisites

Before configuring the Spaceship API:

  1. A Spaceship account — https://www.spaceship.com
  2. The domains registered at Spaceship — you must control the domain at Spaceship to change its nameservers
  3. A Spaceship API key — generated in the Spaceship control panel
  4. The Cloudflare API configured — required; Cloudflare hosts the DNS
  5. The nameservers Cloudflare assigns — GoAdmio reads these automatically
  6. Root access to the GoAdmio Admin Panel
> Tip: If a domain is registered elsewhere (not Spaceship), the Spaceship API cannot change its nameservers. Use the appropriate registrar API, or set nameservers manually at that registrar. See Dynadot API and Reseller Club API.

How to Get a Spaceship API Key

Step 1 — Log in to Spaceship

  1. Go to https://www.spaceship.com
  2. Log in to your account.

Step 2 — Open the API settings

  1. Navigate to Account → API (or Settings → API).
  2. Click Create API Key (or the equivalent in your Spaceship interface).
  3. Copy the API key — and the API secret if Spaceship provides one.
> Tip: Spaceship's API interface may change. If you cannot find the API section, search Spaceship's help documentation for "API key" or contact Spaceship support.

Step 3 — Whitelist your server IP (if required)

Some Spaceship API configurations require you to authorize the IP address that will call the API.

  1. Add your GoAdmio server's public IPv4 to the IP allowlist in Spaceship.
  2. Add the IPv6 address if you use IPv6.
  3. Save.
> Note: If the IP is not allowed, API calls will fail with an authorization error. The server's IP is shown in the GoAdmio panel header or in Server Information.

How to Configure the Integration

  1. Log in to the GoAdmio Admin Panel.
  2. Navigate to Domain API → Spaceship API.
  3. Paste the API Key (and API Secret if required).
  4. Click Save (or Verify).
GoAdmio validates the credentials by making a test API call. If valid, the integration is active.

> Tip: If verification fails, check the error message — it usually indicates an invalid key, a missing IP allowlist entry, or insufficient API permissions.


Using the Integration

Once configured, the integration is used automatically when you run DNS provisioning commands:

Add a single domain

```bash
/go/dns domain.com

↑