> ## Documentation Index
> Fetch the complete documentation index at: https://developers.getbukki.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create a workspace API key and make your first Bukki API request.

## Prerequisites

You need:

* An approved Bukki Pro workspace
* An `OWNER` or `ADMIN` workspace role
* A server-side environment where the API key can be stored securely

<Steps>
  <Step title="Create an API key">
    Open **Workspace Settings → API access**, select only the scopes your integration needs, and choose an expiry period.
  </Step>

  <Step title="Store the secret">
    Copy the complete key when Bukki displays it. The value is shown only once. Save it in your deployment platform's secret manager.
  </Step>

  <Step title="Call the API">
    Send the key in the `X-API-Key` header.

    ```bash theme={null}
    curl "https://api.getbukki.com/v1/contacts?limit=25" \
      -H "X-API-Key: $BUKKI_API_KEY"
    ```
  </Step>

  <Step title="Continue a collection">
    When `page.hasMore` is `true`, send `page.nextCursor` unchanged as the next request's `cursor` value.
  </Step>
</Steps>

<Warning>
  Never put a Bukki API key in browser JavaScript, a mobile application, source control, logs, or analytics events.
</Warning>