Quickstart

Recommended default

Start in sandbox first. Once you have created and rendered one sandbox invoice, moving to live is mostly an environment and access-control decision.

Keep the first goal small

Your first milestone is one valid entity and one valid invoice. Do not design the whole live rollout before you prove the sandbox workflow.

1. Sign Up And Create Your First Entity

Sign up at app.spaceinvoices.com/signup.

New accounts create their first entity after signup. That entity becomes the business context for documents, customers, items, settings, and compliance rules.

If you are building for a single business, create one entity.

If you are building for a platform, your proof of concept can still start with one entity and expand later.

2. Generate The Right API Key

Go to Settings → API Keys in the app.

• use a sandbox key for development, demos, and integration testing
• use an account key when you manage multiple entities
• use an entity key when one business should stay isolated

See Authentication for the full key model.

3. Install The SDK

Installbash

Copy

npm install @spaceinvoices/js-sdk
# or
bun add @spaceinvoices/js-sdk

4. Initialize

Initialize SDKtypescript

Copy

import SpaceInvoices from "@spaceinvoices/js-sdk";

const _sdk = new SpaceInvoices("YOUR_API_KEY");

5. Create Your First Invoice

Create invoicetypescript

Copy

const _invoice = await sdk.invoices.create({
  customer: {
    name: "Acme Corporation",
    email: "billing@acme.com",
  },
  items: [
    {
      name: "Consulting",
      quantity: 10,
      price: 150,
    },
  ],
});

Create Invoice API →

6. Render Or Send It

Render pdftypescript

Copy

// title: Render PDF
const pdf = await sdk.invoices.renderPdf(invoice.id);

// Save to file
fs.writeFileSync("invoice.pdf", pdf);

// Or send as response
res.setHeader("Content-Type", "application/pdf");
res.send(pdf);

Render PDF API →

Or send directly to your customer:

Send emailtypescript

Copy

// title: Send invoice
await sdk.email.send(invoice.id, {
  to: invoice.customer.email,
  subject: "Your invoice #{document_number}",
  body: "Thank you for your business!",
});

Send Email API →

Done. You have proved the basic workflow: entity, key, document, and delivery.

What To Verify Before Going Live

• entity details and country are correct
• your key type matches your tenant model
• PDF rendering and invoice numbering look right
• any email or webhook behavior matches your product expectations

Next Steps

• Authentication — pick the right key model
• Invoices — full invoice lifecycle
• Multi-Tenancy — scale from one entity to many
• Choose Your Path — compare SDK and UI options