Quickstart

This guide takes you from zero to your first API call: you create a token, list your customers, then read one of them.

Prerequisites

A Qwoty account on qwoty.app with a role that has the Developers right (needed to manage API tokens).
A terminal with curl, or any HTTP client.

Create an API token

In Qwoty, go to Settings › Developer › API Tokens and click Create API Token. Enter a Token Name, choose the Role whose rights the token will use, and click Create Token.Click Copy Token: the token is displayed only once. It looks like qwt_prod_ followed by 64 hexadecimal characters.See Authentication for details on token scope and roles.

Store the token in an environment variable

export QWOTY_API_TOKEN="qwt_prod_xxxxxxxxxxxxxxxx"

Keep the token out of your source code and never use it in a browser or mobile app.

List your customers

All endpoints are under https://qwoty.app/api. Send your first request:

curl https://qwoty.app/api/customers \
  -H "Authorization: Bearer $QWOTY_API_TOKEN"

You get the customers of the token’s workspace, sorted by name:

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Acme Corporation",
      "type": "company",
      "id_crm": "crm_001",
      "contact_ids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
      "address_ids": ["c3d4e5f6-a7b8-9012-cdef-123456789012"],
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ]
}

The example is shortened: see List Customers for every field.

Read one customer

Copy an id from the previous response and fetch the full customer, including its custom fields:

curl https://qwoty.app/api/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer $QWOTY_API_TOKEN"

If something goes wrong

Response	What to check
`401` `Missing authorization token`	The header must be exactly `Authorization: Bearer <token>`.
`401` `Invalid or expired token`	The token was mistyped, deleted, or its role was deleted. Create a new one.
`404`	The ID does not exist in the token’s workspace.
`429`	Too many requests at once. Wait and retry: see Rate limits and retries.

Next steps

Permissions

Understand which role rights each endpoint checks.

Error handling

Status codes and error bodies.

Webhooks

Get notified when quotes, products or customers change.

Quotes API

List quotes and read their full content.

Getting started

Core concepts

Resources

Compliance

Policies

Prerequisites

If something goes wrong

Next steps

Permissions

Error handling

Webhooks

Quotes API

​Prerequisites

​If something goes wrong

​Next steps

Permissions

Error handling

Webhooks

Quotes API

Prerequisites

If something goes wrong

Next steps