Quick Start

Follow these four steps to go from zero to a created client.

PrerequisitesCopy Anchor Link

• A Kwill account on the Studio plan or above
• Admin role on your workspace (required to create API keys)

Step 1 — Create an API keyCopy Anchor Link

1. Open Kwill and go to Settings → Developer.
2. Click Create API key, give it a name, and copy the key — it is shown only once.

Store the key in a secret manager or environment variable. Never commit it to source control.

Step 2 — Verify auth with GET /clientsCopy Anchor Link

Set KWILL_API_KEY in your environment, then run:

curl https://usekwill.com/api/v1/clients \
  -H "Authorization: Bearer $KWILL_API_KEY"

You should see a JSON array of your existing clients (empty [] if none yet).

Step 3 — Create your first client with POST /clientsCopy Anchor Link

curl -X POST https://usekwill.com/api/v1/clients \
  -H "Authorization: Bearer $KWILL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme Corp", "email": "billing@acme.com"}'

A successful response returns HTTP 201 with the created client object.

Step 4 — Next stepsCopy Anchor Link